API Google Play Age Signals em 2026: um tutorial passo a passo para faixas etárias, aprovações de mudanças significativas e
A verificação de idade saiu do app e foi para a loja. A lei Texas SB 2420 já está em vigor, o ECA Digital brasileiro começou a retornar sinais de idade em 17 de março de 2026, e Google Play agora entrega aos desenvolvedores uma resposta que antes eles precisavam adivinhar: qual é a idade deste usuário? A Play Age Signals API (beta) é a porta do lado do cliente para essa resposta. Este tutorial segue a ordem de integração que evita retrabalho.
Uma distinção para esclarecer logo de início: o Google Play não exige a API. As leis impõem obrigações aos apps que distribuem nessas jurisdições; o Google fornece as ferramentas e deixa a decisão de conformidade com você. Registre essa decisão por escrito — um histórico de auditoria vale mais do que a lembrança de uma conversa no Slack.
Passo 1 — entenda o que realmente mudou em 2026
Três fatos datados, todos da documentação oficial do Google, definem o escopo:
- Texas. O App Store Accountability Act (SB 2420) está em vigor depois que um tribunal federal de apelações suspendeu a liminar concedida em dezembro de 2025. Para usuários elegíveis, o Google Play retorna sinais de idade para contas criadas após 28 de maio de 2026, e mais atualizações estão prometidas antes dos projetos de lei de verificação de idade em outros estados dos EUA (Ajuda do Play Console).
- Brasil. Desde 17 de março de 2026, a API retorna sinais de idade para usuários no Brasil para os requisitos do ECA Digital (Visão geral dos sinais de idade).
- Divisão de obrigações. A loja verifica, os pais aprovam, e o desenvolvedor deve absorver as faixas etárias mais o status de aprovação dos pais para mudanças significativas, e notificar a loja quando ocorrer uma mudança significativa. O próprio FAQ do Play diz claramente que ele não exige a Age Signals API — as leis exigem experiências adequadas à idade.
Na prática, isso significa que a API resolve a parte mais difícil (você não consegue verificar uma data de nascimento sozinho sem coletar dados de identidade que preferiria não armazenar) e deixa para você a parte que realmente controla: o que o app faz de diferente para uma faixa de 13 a 15 anos em comparação com uma faixa 18+.
Etapa 2 — Adicione a dependência e respeite os limites da superfície
A biblioteca cliente é com.google.android.play:age-signals, e o Google recomenda a versão mais recente, 0.0.4. Os formatos compatíveis são celulares, dobráveis e tablets com Android 6.0 (nível de API 23) ou superior. Adicione-a ao módulo do app:
implementation 'com.google.android.play:age-signals:0.0.4'
Duas restrições passam fácil despercebidas. Primeiro, esta é uma API do lado do cliente, em tempo de execução: os sinais de idade são obtidos enquanto o app está aberto, não enviados a um backend, então qualquer bloqueio do lado do servidor precisa ser guiado pelo que o app obteve e depois decidir como transmitir. Segundo, ao usar a API você aceita seus termos de serviço e concorda em cumprir as políticas de desenvolvedor do Google Play.
Etapa 3 — Peça acesso antes de pedir a idade
Chamar checkAgeSignals() primeiro é o erro clássico. Você precisa resolver o status de compartilhamento por meio de requestAgeSignalsAccess(activity), que retorna um de três estados, e cada um exige uma interface diferente:
COMPARTILHADO— os sinais de idade podem ser lidos. Isso abrange um adulto que verificou ou se autodeclarou em uma região elegível de compartilhamento automático, e um menor supervisionado cujo responsável compartilhou a idade.NOT_SHARED— o usuário ou seu responsável recusou. A experiência alternativa é aplicada; não solicite novamente em loop.VERIFICATION_REQUIRED— nos estados dos EUA aplicáveis, o usuário precisa verificar na Play Store antes de qualquer sinal existir. Envie-o para lá e mantenha a solicitação idempotente no retorno.
O comportamento por região varia por design. Onde a escolha é obrigatória (por exemplo, UE, Reino Unido e Brasil), os usuários escolhem Perguntar antes de compartilhar, Sempre compartilhar ou Nunca compartilhar; em Perguntar antes de compartilhar, o Play exibe um prompt integrado dentro do app. Nos estados dos EUA onde se aplica, não há prompt dentro do app — a Play Store é responsável pela verificação, e as chamadas retornam SHARED ou VERIFICATION_REQUIRED. Para contas supervisionadas, os pais gerenciam o compartilhamento no app Family Link. Se o usuário dispensar o prompt, o Play o exibe novamente algumas vezes e depois o suprime — por isso um bloqueio rígido em NOT_SHARED é uma decisão de produto, não um padrão técnico.
Etapa 4 — Leia os campos da resposta sem interpretar null errado
checkAgeSignals() retorna os campos que definem a lógica dos seus ramos (referência da resposta):
ageLower/ageUpper— limites inclusivos da faixa do usuário. As faixas padrão são 0-12, 13-15, 16-17 e 18+.ageUpperé nulo para a faixa mais alta, sem limite superior.ageRangeSource—TIER_Aautodeclarado;TIER_Bgerenciado por pai/responsável;TIER_Cavaliado por cartão de crédito, e-mail, avaliação por selfie, documento oficial de identidade ou ID fiscal;TIER_Ddocumento oficial de identidade mais avaliação por selfie, ou ID digital. Trate o nível como um grau de confiança e registre-o ao lado do caminho que você seguiu.significantChangeStatus/significantChangeApprovalDate—APPROVED,PENDING,DECLINEDou null quando a jurisdição não se aplica.installId— atribuído a instalações supervisionadas, usado para avisos de aprovação de app revogada.
A armadilha: limites nulos não significam "criança". Ambos os limites retornam nulos para um adulto verificado, e também retornam nulos quando o status é NOT_SHARED ou VERIFICATION_REQUIRED. Se o seu código trata "nulo" como "restrito", você vai bloquear adultos pagantes. Ramifique primeiro pelo status, depois pelos limites, e trate limites nulos como "desconhecido, use a faixa padrão", a menos que o status indique o contrário.
Etapa 5 — Defina faixas etárias personalizadas no Play Console se o seu produto precisar delas
As faixas padrão raramente correspondem a uma regra real de produto. Na página Sinais de idade do Play Console, a aba Faixas de idade personalizadas aceita até três idades mínimas; as idades mínimas devem ter pelo menos dois anos de diferença e podem ser alteradas uma vez por ano. Defina um mínimo de 15 e um usuário de 0 a 14 retorna ageLower=0, ageUpper=14, enquanto um usuário de 15+ retorna apenas ageLower=15. Defina 13 e 17 e você terá três faixas: 0-12, 13-16, 17+.
Como a mudança é anual, defina as faixas a partir das regras do seu produto e dos compromissos da sua ficha do app na loja antes de salvar. Reajustar depois é uma solicitação de mudança, não um ajuste de configuração.
Etapa 6 — Configurar mudanças significativas e classificações etárias de IAP
"Mudança significativa" é definida por você, não pelo Google. Quando você faz uma — um novo recurso social, uma mudança no compartilhamento de dados, uma nova superfície de compra — notifique o Play na página de sinais de idade no Play Console; não é necessária uma nova versão do app. Os pais então aprovam ou recusam, e você lê o resultado por meio de significantChangeStatus. O Play declara que não vai revogar o acesso ao app nem desativar um app quando um pai recusa: a consequência é você quem define, e o caminho de notificação para aprovações revogadas passa pelo installId.
O Texas adiciona uma faixa separada para o dinheiro: produtos dentro do app podem precisar de uma classificação etária própria, distinta da classificação indicativa do app. Você pode defini-la no Play Console ou pela Publishing API, e o Play a exibe no fluxo de aprovação de compra para usuários do Texas no Play Billing. Trate a classificação do SKU como parte do checklist de lançamento, não como algo secundário — um fluxo de compra que a ignora é o tipo de lacuna que aparece como constatação de conformidade, e não como falha.
Passo 7 — Trate os códigos de erro como dois grupos, não como onze casos
A tabela de erros na verdade tem dois grupos. Recuperáveis: -1 API indisponível, -2 Play Store ausente, -3 rede, -4 Play Services ausente, -5 não é possível vincular ao serviço, -6 Play Store desatualizada, -7 Play Services desatualizado, -8 erro transitório do cliente. Não recuperáveis: -9 app não instalado pelo Google Play, -10 versão do SDK não é mais compatível, -100 erro interno (contate o suporte a desenvolvedores do Play com o nome da API no assunto).
Para o primeiro grupo, use uma nova tentativa limitada com backoff exponencial e uma condição de saída, e exiba a mensagem acionável (atualize a Play Store, verifique a conectividade). Para o segundo grupo, caia imediatamente na sua experiência padrão e registre no log — uma tempestade de novas tentativas em APP_NOT_OWNED só gasta bateria. Builds instalados por sideload sempre cairão aí, e é também por isso que os testes precisam do gerenciador falso documentado em vez de um APK instalado manualmente.
Etapa 8 — Mantenha a postura de dados defensável
Duas perguntas diferentes sobre dados se confundem aqui. A biblioteca cliente do Play Age Signals em si não coleta nem compartilha dados com terceiros; a Play Store processa os sinais no dispositivo. O que você faz com os valores depois de lê-los é inteiramente sua decisão, e é aí que mora a exposição a políticas: declare isso na sua política de privacidade, limite a retenção ao que a experiência adequada à idade exige e não reutilize os sinais para publicidade, criação de perfis ou analytics — os termos restringem o uso ao fornecimento de experiências adequadas à idade, e o uso indevido encerra o acesso à API e coloca o próprio app em risco.
O Google também recomenda chamar a API junto com a Play Integrity API para que a resposta não possa ser falsificada por um build adulterado. É um acréscimo barato quando você já está integrando e uma adaptação cara depois de um incidente.
Verificação pré-envio: status de acesso tratado para os três estados, limites nulos nunca tratados como "menor", faixas personalizadas congeladas conforme as regras do seu produto, notificação de mudança significativa sob responsabilidade de uma pessoa nomeada, classificações de SKU de IAP definidas para o Texas, erros repetíveis limitados, política de privacidade atualizada, Play Integrity considerado. Oito itens, nenhum dos quais a loja vai verificar por você.
Fontes: documentação da Play Age Signals API em developer.android.com (visão geral, integração, respostas, tratamento de erros) e a Ajuda do Play Console sobre os próximos projetos de lei de lojas de apps nos EUA, ambas verificadas em 23/10/2026. O Google Play não publica limites de aplicação de políticas nem determinações legais por app; nenhuma é inferida aqui.
Gerencia contas de desenvolvedor em escala? Cuidamos do lado operacional.
Recebemos sua mensagem e responderemos em até 24 horas.
← Voltar para editar