Usar a API Play Age Signals (Beta)

Ao usar a API Play Age Signals (Beta), você concorda com os Termos de Serviço e com todas as Políticas para Desenvolvedores do Google Play. Para solicitar o status e a faixa etária do usuário, chame a API do app durante a execução. A API Play Age Signals só retorna dados de usuários com base em regiões onde o Google Play é obrigado por lei a fornecer dados de categoria de idade.

O Google Play retorna uma faixa etária com base nas faixas etárias definidas pela jurisdição e regiões aplicáveis. 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, mas elas podem mudar com base nos requisitos regionais.

Integrar a API Play Age Signals ao app

Para integrar a API Play Age Signals ao app, adicione a seguinte dependência ao arquivo build.gradle do app:

implementation 'com.google.android.play:age-signals:0.0.1-beta01'

Solicitar indicadores de idade

Veja um exemplo de como fazer uma solicitação de indicadores de idade:

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

Como alternativa, para 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ê fornecer idades mínimas de 9, 15 e 17 anos, um usuário de 14 anos se enquadrará na faixa etária de 10 a 15 anos. As idades mínimas precisam ter uma diferença de pelo menos 2 anos e podem ser alteradas uma vez por ano.

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 Idades mínimas do app, insira até três idades mínimas para seu app.
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.

Processar códigos de erro da API

Se o app fizer uma solicitação da API Play Age Signals (Beta) 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.