Usar a API Play Age Signals (Beta)

// Create an instance of a manager
val ageSignalsManager =
    AgeSignalsManagerFactory.create(ApplicationProvider.getApplicationContext())

// Request an age signals check
ageSignalsManager
    .checkAgeSignals(AgeSignalsRequest.builder().build())
    .addOnSuccessListener { ageSignalsResult ->
        // Store the install ID for later...
        val installId = ageSignalsResult.installId()

        if (ageSignalsResult.userStatus() == AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_DENIED) {
          // Disallow access...
        } else {
           // Do something else if the user is SUPERVISED, VERIFIED, etc.
        }
    }

// Create an instance of a manager
AgeSignalsManager ageSignalsManager =
    AgeSignalsManagerFactory.create(ApplicationProvider.getApplicationContext());

// Request an age signals check
ageSignalsManager
    .checkAgeSignals(AgeSignalsRequest.builder().build())
    .addOnSuccessListener(
        ageSignalsResult -> {
          // Store the install ID for later...
          String installId = ageSignalsResult.installId();

          if (ageSignalsResult
              .userStatus()
              .equals(AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_DENIED)) {
            // Disallow access ...
          } else {
            // Do something else if the user is SUPERVISED, VERIFIED, etc.
          }
        });

Os indicadores de idade são armazenados pelo Google Play no dispositivo para cada usuário. Quando um usuário com uma Conta do Google supervisionada entra em uma nova faixa etária, o Google Play atualiza automaticamente os indicadores de idade armazenados em cache para esse usuário em um período de 2 a 8 semanas após o aniversário dele.

(Opcional) Receber faixas etárias personalizadas

As faixas etárias padrão que a API retorna em jurisdições e regiões aplicáveis são 0 a 12, 13 a 15, 16 a 17 e 18 anos ou mais. Elas podem mudar no futuro com base nos requisitos locais.

Se quiser personalizar as faixas etárias de acordo com as idades mínimas do seu app, informe essas idades na página Indicadores de idade do Google Play Console. A API Age Signals retorna as faixas etárias personalizadas. Por exemplo, se você inserir 9, 15 e 17 anos, um usuário de 14 anos vai se enquadrar na faixa etária de 10 a 15 anos.

Para personalizar as faixas etárias retornadas pela API Age Signals, informe as idades mínimas do seu app:

1. Acesse a página Indicadores de idade no Play Console.
2. Na guia Faixas etárias personalizadas, insira até três idades mínimas para seu app. Elas precisam ter uma diferença de pelo menos 2 anos e podem ser alteradas uma vez por ano.
3. Clique em Salvar.

Respostas de indicadores de idade

A resposta da API Play Age Signals (Beta) inclui os seguintes campos e valores. Os valores estão sujeitos a mudanças. Se você quiser os valores mais recentes, solicite uma resposta da API quando o app for aberto. Você é responsável por oferecer experiências adequadas à idade usando esses indicadores.

Exemplos de respostas

Para um usuário verificado, você receberia o seguinte:

• userStatus seria AgeSignalsVerificationStatus.VERIFIED.
• Os outros campos de resposta ficariam vazios.

Para um usuário supervisionado, você receberia o seguinte:

• userStatus seria AgeSignalsVerificationStatus.SUPERVISED.
• ageLower seria um número (por exemplo, 13).
• ageUpper seria um número (por exemplo, 15).
• mostRecentApprovalDate seria um objeto de data Java (por exemplo, 2026-01-01) ou vazio (se nenhuma mudança significativa tiver sido aprovada).
• installID seria um ID alfanumérico gerado pelo Google Play (por exemplo, 550e8400-e29b-41d4-a716-446655441111).

Para um usuário supervisionado com uma aprovação de mudança significativa pendente, você receberia o seguinte:

• userStatus seria AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING.
• ageLower seria um número (por exemplo, 13).
• ageUpper seria um número (por exemplo, 15).
• mostRecentApprovalDate seria um objeto de data Java (por exemplo, 2026-01-01) ou vazio (se nenhuma mudança significativa tiver sido aprovada).
• installID seria um ID alfanumérico gerado pelo Google Play (por exemplo, 550e8400-e29b-41d4-a716-446655441111).

Processar códigos de erro da API

Se o app fizer uma solicitação da API Play Age Signals e a chamada falhar, ele vai receber um código de erro. Esses erros podem acontecer por vários motivos, como o app da Play Store estar desatualizado.

Estratégia de repetição

Em situações em que o usuário está em sessão, recomendamos implementar uma estratégia de nova tentativa com um número máximo de tentativas como condição de saída para que o erro interfira o mínimo possível na experiência.