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 VERIFIED, DECLARED, SUPERVISED, 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.
          }
        });

(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.

Se quiser personalizar as faixas etárias padrão de acordo com as idades mínimas do seu app, informe essas idades na página Indicadores de idade do Google Play Console. As faixas etárias retornadas vão substituir a resposta padrão da API. Por exemplo, se você inserir idades mínimas de 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 padrão retornadas pela API Age Signals, você pode informar 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 usuários no Brasil

No Brasil, userStatus só pode ser DECLARED, UNKNOWN ou null.

Para um usuário que declarou a idade e a compartilha com apps, você receberia o seguinte:

• userStatus seria AgeSignalsVerificationStatus.DECLARED.
• ageLower seria um número (por exemplo, 13).
• ageUpper seria um número ou null (por exemplo, 15).
• Outros campos de resposta seriam null.

Para um usuário com idade desconhecida, você receberia o seguinte:

• userStatus seria AgeSignalsVerificationStatus.UNKNOWN.
• Outros campos de resposta seriam null.

Para um usuário cuja idade não é compartilhada com apps, você receberia o seguinte:

• userStatus seria null.
• Outros campos de resposta seriam null.

O status do usuário pode mudar para DECLARED quando a idade dele estiver disponível para compartilhamento.

Exemplos de respostas para usuários nos estados dos EUA

Nos estados aplicáveis dos EUA, userStatus pode ser VERIFIED, SUPERVISED, SUPERVISED_APPROVAL_PENDING, SUPERVISED_APPROVAL_DENIED, UNKNOWN ou null.

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

• userStatus seria AgeSignalsVerificationStatus.VERIFIED.
• ageLower seria um número (por exemplo, 18).
• ageUpper seria um número ou null (por exemplo, null).
• Outros campos de resposta seriam null.

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 ou null (por exemplo, 15).
• mostRecentApprovalDate seria um objeto de data Java (por exemplo, 2026-01-01) ou null (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ê vai receber o seguinte:

• userStatus seria AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING.
• ageLower seria um número (por exemplo, 13).
• ageUpper seria um número ou null (por exemplo, 15).
• mostRecentApprovalDate seria um objeto de data Java (por exemplo, 2026-01-01) ou null (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 de 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 Google 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.