Guia de integração da Play Age Signals API: v0.0.6 para aplicações Android
As três chamadas da Play Age Signals 0.0.6 em Kotlin, tabela de decisão para cada estado, nível e limite, erros, migração da 0.0.3 e 0.0.4, testes e como iniciar a sua própria verificação da idade.

Em resumo
Para integrar a Play Age Signals API hoje, adicione com.google.android.play:age-signals:0.0.6, chame requestAgeSignalsAccess com uma Activity e chame checkAgeSignals apenas quando o estado for SHARED.[1][2]
- Leia a idade a partir de
ageLower. O nível indica como a idade foi apurada, e null nunca é um adulto. - O manifesto da biblioteca 0.0.6 declara minSdk 24, embora o guia indique a API 23.[1][11]
- O sinal permanece na sua aplicação. Se precisar da sua própria verificação da idade, inicie-a sem o sinal.
Este é o guia de engenharia para a Play Age Signals API: Android primeiro, depois Flutter, React Native, Expo e Unity. Para saber quem é afetado e o que começa em janeiro de 2027, leia Google Play Age Signals API: o que muda em janeiro de 2027. A Google disponibiliza a API e não o obriga a chamá-la; uma lei poderá fazê-lo.
Todas as classes, métodos e enumerações abaixo foram verificados com as páginas da Google e com a biblioteca 0.0.6 publicada em 22 de novembro de 2026; o código Kotlin do sinal compila com essa biblioteca.
Do que necessita
A API corre em telemóveis, dobráveis e tablets, através da aplicação Play Store no dispositivo.[1][5]
- Defina
minSdkcomo 24 (consulte o aviso). - Distribua através da Google Play: os termos limitam a API a aplicações que a Google Play atualiza.[5]
- Abra a página Sinais de idade na Play Console: idades personalizadas, alterações significativas e aprovações revogadas estão lá.[3][8][9]
- Responda pessoalmente ao formulário de segurança dos dados da Play. A Google indica que a biblioteca de cliente não recolhe dados e que a decisão sobre o formulário é sua.[5]
Atenção
A página de configuração da Google indica Android 6.0, nível de API 23.[1] O manifesto dentro da biblioteca 0.0.6 declara minSdkVersion 24; a 0.0.3 e a 0.0.4 declaravam 23.[11] Uma aplicação com minSdk 23 pode deixar de compilar na fusão de manifestos após a atualização. Aumentar para 24 é a solução simples.
- fevereiro de 20260.0.3Uma chamada,
userStatus, adiciona DECLARED. - julho de 20260.0.4Duas chamadas, os níveis substituem
userStatus. - novembro de 20260.0.6Global, adiciona
getApplicableAgeFeatures. - 11 de dezembro de 2026Todos os utilizadoresData definida pela Google para respostas a todos os utilizadores.
Versões da biblioteca, a partir das notas de lançamento e da faixa informativa da Google.[2][4] Até essa data, conte com alguns utilizadores sem resposta.
Adicionar a biblioteca
Uma dependência.[1] O gestor simulado para testes está no mesmo artefacto.[11]
dependencies {
implementation("com.google.android.play:age-signals:0.0.6")
}
1getApplicableAgeFeatures (opcional)
Se a partilha é obrigatória para este utilizador.
2requestAgeSignalsAccess
Pode mostrar o próprio pedido da Google Play.
O estado é SHARED
3checkAgeSignals
Ler limites, origem e estado da alteração.
Sem idade da Google
Utilize a sua predefinição adequada à idade.
A ordem das chamadas em 0.0.6.[2]
Passo 1: a partilha é obrigatória para este utilizador
A chamada é opcional.[2] features() contém MANDATORY_SHARING apenas para utilizadores em regiões cujas leis exigem que as lojas de aplicações partilhem informações sobre a idade, e está vazio para todos os outros.[2]
val manager = AgeSignalsManagerFactory.create(applicationContext)
manager.getApplicableAgeFeatures(ApplicableAgeFeaturesRequest.builder().build())
.addOnSuccessListener { result ->
val mandatory = ApplicableAgeFeature.MANDATORY_SHARING in result.features()
// Use it to word your own screen. It is not an age.
}
.addOnFailureListener { error -> handleAgeSignalsError(error) }
Nota
Obrigatório significa que a partilha do utilizador é obrigatória. Não diz nada sobre a forma como a idade foi estabelecida: a Google documenta MANDATORY_SHARING com TIER_A, TIER_B, TIER_C e TIER_D.[3]
Passo 2: pedir acesso
A documentação da Google indica requestAgeSignalsAccess(Activity); o método aceita um AgeSignalsAccessRequest que contém a Activity.[2] Chame-o num local onde seja aceitável apresentar um pedido.
val request = AgeSignalsAccessRequest.builder()
.setActivity(this)
.build()
manager.requestAgeSignalsAccess(request)
.addOnSuccessListener { access ->
when (access.ageSignalsStatus()) {
AgeSignalsStatus.SHARED -> readSignals(manager)
AgeSignalsStatus.NOT_SHARED -> applyGate(AgeGate.NoSignal)
AgeSignalsStatus.VERIFICATION_REQUIRED -> applyGate(AgeGate.VerifyInPlay)
else -> applyGate(AgeGate.NoSignal) // UNSPECIFIED or null
}
}
.addOnFailureListener { error -> handleAgeSignalsError(error) }
O que o utilizador vê depende da região e da configuração:[2]
| Utilizador | Pedido | Estado |
|---|---|---|
| Estado dos EUA onde as lojas têm de fornecer idades verificadas; utilizador verificado ou supervisionado | Nenhum | SHARED |
| O mesmo, ainda não verificado | Nenhum na sua aplicação; a Play trata disso | VERIFICATION_REQUIRED |
| Noutros locais, Perguntar antes de partilhar (a predefinição[14]) | Pedido da Play dentro da aplicação | SHARED ou NOT_SHARED |
| Noutros locais, Partilhar sempre | Nenhum | SHARED |
| Noutros locais, Nunca partilhar | Nenhum | NOT_SHARED |
| Noutros locais, supervisionado | Nenhum; o progenitor decide no Family Link | SHARED ou NOT_SHARED |
Após algumas dispensas, a Play deixa de apresentar o pedido, pelo que não deve efetuar chamadas em ciclo.[2] Onde a partilha é obrigatória, a definição fica fixa em Partilhar sempre.[14]
Mapeie a sua barreira de idade para o sinal
Mostre-nos a sua barreira de idade e os seus mercados, e mostrar-lhe-emos quais os ramos que necessitam de uma verificação própria e quais não.
Passo 3: ler o resultado
Todos os campos aceitam valores nulos, pelo que deve converter uma vez e manter um único tipo na sua aplicação. Este mapeamento lê a idade apenas a partir dos limites.
sealed interface AgeGate {
data object NoSignal : AgeGate
data object VerifyInPlay : AgeGate
data class Range(
val lower: Int,
val upper: Int?, // null = top band, not "adult"
val source: Int?, // AgeRangeSource.TIER_A to TIER_D
val changeStatus: Int? // SignificantChangeStatus
) : AgeGate {
fun isAtLeast(age: Int) = lower >= age
}
}
fun toAgeGate(r: AgeSignalsResult): AgeGate {
val lower: Int = r.ageLower() ?: return AgeGate.NoSignal
return AgeGate.Range(
lower, r.ageUpper(), r.ageRangeSource(), r.significantChangeStatus()
)
}
private fun readSignals(manager: AgeSignalsManager) {
manager.checkAgeSignals(AgeSignalsRequest.builder().build())
.addOnSuccessListener { result -> applyGate(toAgeGate(result)) }
.addOnFailureListener { error -> handleAgeSignalsError(error) }
}
As constantes de estado, origem e alteração são números inteiros em que 0 é UNSPECIFIED.[10][11] Processe-o num ramo else. O guia 0.0.3 da Google recomendou um novo pedido ao abrir a aplicação porque os valores mudam[12]; um utilizador também pode desativar a partilha mais tarde.[14]
Nota
Esse guia também recomenda chamar a Play Integrity API em paralelo, para que a chamada provenha de uma compilação não adulterada num dispositivo certificado.[12] O sinal é uma resposta do lado do cliente: não confie numa faixa que um cliente modificado envie para o seu servidor.
A tabela de decisão: estado x origem x limites
Os intervalos predefinidos são 0-12, 13-15, 16-17 e 18+.[3] A última coluna é o nosso conselho de engenharia, não o da Google.
| Estado | Origem | Inferior / superior | O que significa | O que o seu código faz |
|---|---|---|---|---|
| Exceção | nenhum | nenhum | Sem resposta[7] | Tentar novamente se o erro for repetível; caso contrário, sem sinal |
NOT_SHARED | null | null / null | O utilizador ou o progenitor não concordou em partilhar[2][3] | Predefinição adequada à idade, sem novo pedido |
VERIFICATION_REQUIRED | null | null / null | Não verificado, numa região onde a verificação e a partilha são obrigatórias[2][3] | Encaminhe para a Play Store, mantenha a predefinição |
SHARED | TIER_A | 13 / 15 | O utilizador forneceu a idade à Google, que pode tê-la confirmado ou não[3] | Aplique a faixa etária |
SHARED | TIER_A | 18 / null | Igual, faixa etária de adultos[3] | Aplique-o; adicione uma verificação apenas se a lei ou o risco exigirem mais |
SHARED | TIER_B | 13 / 15 | Idade gerida por um progenitor ou tutor[3] | Aplique a faixa etária, leia o estado da alteração |
SHARED | TIER_C | 18 / null | Avaliado por cartão de crédito, e-mail, selfie, documento de identificação oficial ou número de identificação fiscal[3] | Aplique a faixa etária |
SHARED | TIER_D | 18 / null | Documento de identificação oficial mais selfie, ou uma identificação digital[3] | Aplique a faixa etária |
SHARED | qualquer | null / qualquer | Não consta na tabela de respostas da Google | Tratar como ausência de sinal |
Três interpretações causam a maioria dos erros:
- TIER_A não significa "não verificado". Um adulto que verificou a idade com um documento de identificação digital mas partilha por opção também chega como TIER_A.[3] TIER_C e TIER_D são devolvidos apenas em regiões onde a verificação da idade é obrigatória, por exemplo no Texas.[3] A referência da classe classifica TIER_A como "autodeclarado"; o guia de respostas é mais prudente.[3][10]
- TIER_B não é uma idade. Indica quem faz a gestão. Leia os limites.
- Limites nulos não representam um adulto verificado. Um comentário no exemplo em Java da Google sugere-o; o exemplo em Kotlin da Google indica que o utilizador não está a partilhar, e a tabela de respostas está de acordo com o exemplo em Kotlin.[2][3]
Quando parar por aqui
Se a faixa responder à sua questão e nenhuma lei ou risco exigir mais, pare. Uma segunda verificação a cada utilizador é difícil de conciliar com a minimização de dados, e na Califórnia o sinal é o indicador principal, a menos que disponha internamente de informações claras e convincentes.[15]
Nos casos em que um ramo termina sem sinal, a conceção do passo seguinte encontra-se em o que fazer em NOT_SHARED, TIER_A ou ausência de resposta.
Precisa de uma resposta quando o sinal não fornece nenhuma
Peça uma demonstração da estimativa da idade na sua aplicação: selfie primeiro, documento apenas em casos limítrofes.
Idades mínimas personalizadas
No separador Intervalos de idade personalizados, introduza até três idades mínimas, com pelo menos dois anos de intervalo, alteráveis uma vez por ano. Estas substituem a resposta predefinida.[3]
| Idades mínimas configuradas | Intervalos devolvidos | Faixa superior |
|---|---|---|
| Nenhuma (predefinição) | 0-12, 13-15, 16-17, 18+ | 18 / null |
| 15 | 0-14, 15+ | 15 / null |
| 13, 17 | 0-12, 13-16, 17+ | 17 / null |
| 11, 13, 15 | 0-10, 11-12, 13-14, 15+ | 15 / null |
Exemplos do guia de respostas da Google.[3]
Exemplo
Configurou 13 e 17. Uma pessoa de 25 anos recebe agora 17 / null, o mesmo que uma pessoa de 17 anos. O código que interpreta um ageUpper nulo como adulto permite que pessoas de 17 anos acedam a uma funcionalidade para maiores de 18 anos, pelo que deve manter 18 na sua lista se aplicar a barreira aos 18. Os limites documentados terminam aos 18[3]: esta API não consegue responder a uma barreira de 21 anos.
Alterações significativas e autorizações revogadas
Ambas as funcionalidades destinam-se a utilizadores supervisionados. Determinar que lei torna uma alteração significativa é uma decisão sua, e não da Play[8]; as regras estaduais constam de App Store Accountability Acts.
Notifica a Play
Alteração significativa
- Até 3 alterações, com até 90 dias de antecedência, com mais de 2 dias de intervalo
- Descrição em inglês obrigatória, apresentada textualmente aos pais
significantChangeStatusé APPROVED, PENDING ou DECLINED- A sua aplicação deve restringir a funcionalidade alterada
Cumulativo: uma aprovação abrange todas as alterações pendentes[8]
A Play notifica-o
Aprovação revogada
installIdé por utilizador e dispositivo, e não sobrevive a uma reposição- Pode armazená-lo no seu servidor apenas para esta finalidade
- Os IDs revogados surgem como um CSV na Play Console
- Cada entrada é eliminada após 90 dias, pelo que deve descarregar de forma programada
Um ID pode surgir mais do que uma vez[9]
Bloqueie o acesso à funcionalidade alterada, e não a toda a aplicação, em PENDING e DECLINED. O estado é nulo para contas não supervisionadas e para contas supervisionadas sem alterações registadas.[3]
Erros e dispositivos não suportados
As falhas surgem como AgeSignalsException. A Google aconselha repetir as tentativas até um limite máximo.[7]
// -8 (CLIENT_TRANSIENT_ERROR) to -1 (API_NOT_AVAILABLE) are marked retryable
private val RETRYABLE =
AgeSignalsErrorCode.CLIENT_TRANSIENT_ERROR..AgeSignalsErrorCode.API_NOT_AVAILABLE
private var attempts = 0
fun handleAgeSignalsError(e: Exception) {
val code = (e as? AgeSignalsException)?.errorCode
if (code in RETRYABLE && attempts++ < 3) retryLater()
else applyGate(AgeGate.NoSignal)
}
| Código | Constante | Tentar novamente | Ação |
|---|---|---|---|
| -1, -6 | API_NOT_AVAILABLE, PLAY_STORE_VERSION_OUTDATED | Sim | Pedir para atualizar a Play Store |
| -2 | PLAY_STORE_NOT_FOUND | Sim | Pedir para instalar ou ativar a Play Store |
| -3 | NETWORK_ERROR | Sim | Pedir para verificar a ligação |
| -4, -7 | PLAY_SERVICES_NOT_FOUND, PLAY_SERVICES_VERSION_OUTDATED | Sim | Pedir para instalar, ativar ou atualizar os Play Services |
| -5 | CANNOT_BIND_TO_SERVICE | Sim | Espera exponencial entre tentativas, depois atualizar a Play Store |
| -8 | CLIENT_TRANSIENT_ERROR | Sim | Tentativas limitadas, depois tentar mais tarde |
| -9 | APP_NOT_OWNED | Não | Não instalada pelo Google Play: instalação lateral ou outra loja |
| -10 | SDK_VERSION_OUTDATED | Não | Distribua uma versão mais recente da biblioteca |
| -11 | DEVICE_NOT_SUPPORTED | Não | Tipo de dispositivo não suportado; novidade na 0.0.6[4] |
| -100 | INTERNAL_ERROR | Não | O texto da Google ainda sugere tentativas limitadas; o código acima não efetua nova tentativa |
Referência de códigos de erro da Google.[7] Um erro não é uma idade: reverta para a experiência predefinida.
Migrar a partir de 0.0.3 e 0.0.4
A versão 0.0.3 ainda devolve respostas mas não recebe atualizações.[12] A migração a partir desta exige reescrever o caminho de leitura; a partir da 0.0.4 a mudança é reduzida.
| No seu código | Na 0.0.6 | De |
|---|---|---|
Apenas checkAgeSignals | Primeiro requestAgeSignalsAccess[4] | 0.0.3 |
userStatus() | Removidos: ageRangeSource() e significantChangeStatus()[4] | 0.0.3 |
VERIFIED | TIER_C ou TIER_D (a nossa interpretação) | 0.0.3 |
DECLARED | TIER_A, ou TIER_B se for gerido por um progenitor (a nossa interpretação) | 0.0.3 |
SUPERVISED | TIER_B (a nossa interpretação) | 0.0.3 |
SUPERVISED_APPROVAL_PENDING, SUPERVISED_APPROVAL_DENIED | TIER_B com PENDING ou DECLINED (a nossa interpretação) | 0.0.3 |
UNKNOWN, null | O estado de acesso: VERIFICATION_REQUIRED ou NOT_SHARED (a nossa interpretação) | 0.0.3 |
mostRecentApprovalDate() | significantChangeApprovalDate()[4] | 0.0.3 |
| Duas chamadas, níveis | Inalterado; adicione getApplicableAgeFeatures se for útil[4] | 0.0.4 |
| Tratamento de erros | Adicione DEVICE_NOT_SUPPORTED[4] | Ambos |
minSdk 23 | A biblioteca declara 24[11] | Ambos |
A Google não publica nenhum mapeamento valor a valor. As linhas marcadas como "a nossa interpretação" resultam da comparação de ambas as definições.[3][12]
Atenção
As antigas constantes de AgeSignalsVerificationStatus ainda estão incluídas na versão 0.0.6, pelo que as importações compilam embora userStatus() não exista.[11] Na versão 0.0.3, VERIFIED era 0; na versão 0.0.6, 0 é UNSPECIFIED.[10][11] Limpe os números inteiros em cache ao atualizar.
Testar com FakeAgeSignalsManager e testadores de licença
O FakeAgeSignalsManager nunca comunica com a Play Store; a sua referência limita-o a testes unitários e desenvolvimento inicial.[32] Injete o gestor para poder substituí-lo.
val fake = FakeAgeSignalsManager()
// Sharing is mandatory for this user
fake.setNextApplicableAgeFeaturesResult(
ApplicableAgeFeaturesResult.builder()
.setFeatures(setOf(ApplicableAgeFeature.MANDATORY_SHARING))
.build()
)
// Verification still pending in Play
fake.setNextAgeSignalsAccessResult(
AgeSignalsAccessResult.builder()
.setAgeSignalsStatus(AgeSignalsStatus.VERIFICATION_REQUIRED)
.build()
)
// Supervised 13 to 15, change waiting for the parent
fake.setNextAgeSignalsResult(
AgeSignalsResult.builder()
.setAgeRangeSource(AgeRangeSource.TIER_B)
.setAgeLower(13)
.setAgeUpper(15)
.setSignificantChangeStatus(SignificantChangeStatus.PENDING)
.setInstallId("fake_install_id_123")
.build()
)
// Fails checkAgeSignals
fake.setNextAgeSignalsException(
AgeSignalsException(AgeSignalsErrorCode.NETWORK_ERROR)
)
- Cubra cada estado, uma faixa de menor, uma faixa de adulto, limites nulos e um erro por chamada (
setNextRequestAgeSignalsAccessExceptionesetNextApplicableAgeFeaturesExceptionfazem falhar as outras duas). - Execute a chamada real com um testador de licenças: normalmente, uma aplicação não atualizada pela Play recebe
APP_NOT_OWNED; os testadores podem instalar lateralmente uma versão de depuração.[6] - Mantenha o nome do pacote idêntico ao da aplicação publicada na Play e inicie sessão com a conta de testador.[6]
Flutter, React Native, Expo e Unity
Estes são pacotes da comunidade ou de frameworks, não da Google, e a inclusão nesta lista não constitui uma recomendação. Verifique a versão da biblioteca antes de publicar.
| Tecnologia | Pacote verificado | Biblioteca | Saiba antes de publicar |
|---|---|---|---|
| Expo | expo-age-range 58.0.3 | 0.0.4 | Na web e em versões do iOS anteriores à versão 26 devolve lowerBound: 18, tal como um adulto[17] |
| React Native | react-native-play-age-range-declaration 3.0.5 | 0.0.4 | Também integra outras lojas e a Apple[19] |
| Flutter | age_range_signals 0.10.1 | 0.0.4 | Fluxo de duas chamadas, suporte para testadores de licenças[18] |
| Unity | unity-play-age-signals | 0.0.4 | GPL-3.0; os retornos de chamada podem ser executados fora da thread principal[20] |
Consultado a 22 de novembro de 2026 a partir da página de cada pacote ou ficheiro de compilação.[17][18][19][20] A equipa da Unity escreveu em dezembro de 2025 que a Unity não lançaria um plugin dedicado.[21]
Um pacote na versão 0.0.4 não tem getApplicableAgeFeatures nem DEVICE_NOT_SUPPORTED. Se precisar deles, crie uma pequena ponte nativa. O lado da Apple é comparado em Play Age Signals vs Apple Declared Age Range.
Não registe, não partilhe nem crie perfis
Os termos da Google limitam as informações a experiências adequadas à idade em conformidade com as leis, na aplicação requerente.[5] A política proíbe publicidade, analítica, criação de perfis e a venda, partilha ou transferência dos dados para terceiros, exceto quando estritamente exigido por lei.[13]
- Mantenha faixas, níveis e o
installIdfora de registos, relatórios de falhas e eventos de analítica: essas ferramentas pertencem habitualmente a terceiros. - Mantenha o resultado em bruto em memória sempre que possível e guarde a decisão sobre a funcionalidade em vez do nível.
- Nunca associe o sinal a um fornecedor de verificação da idade, incluindo a Didit.
- Na Califórnia, não incite os utilizadores a alterar as respetivas informações de idade e não partilhe nenhum sinal com terceiros para finalidades não exigidas pelo título.[15]
- Consulte o departamento jurídico antes de solicitar um sinal para cada utilizador: a lei da Califórnia proíbe pedidos que nem ela nem outra lei aplicável exijam.[15]
Assim, a mensagem "visite a Play Store" pertence a VERIFICATION_REQUIRED, e não a um utilizador da Califórnia cuja faixa suscite dúvidas. A página regional da Google lista a Califórnia e o Brasil como obrigatórios a partir de janeiro de 2027 e o Alabama como "Detalhes em breve".[16] As obrigações da Califórnia constam do guia do Digital Age Assurance Act.
Após o sinal: inicie a sua própria verificação
A sua aplicação decide se é necessária uma verificação; o pedido inclui um fluxo de trabalho e o seu ID de utilizador, nunca a resposta da Google. Chame a Didit a partir do seu servidor, pois a chave de API não deve chegar ao dispositivo.
curl -X POST https://verification.didit.me/v3/session/ \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workflow_id": "YOUR_AGE_WORKFLOW_ID",
"vendor_data": "user-42"
}'
A resposta 201 contém session_id, session_token e url.[25] Envie apenas o token para a aplicação e, em seguida, inicie o SDK:[26]
// Once, in Application.onCreate: DiditSdk.initialize(this)
lifecycleScope.launch {
DiditSdk.state.collect { state ->
if (state is DiditSdkState.Ready) DiditSdk.launchVerificationUI(this@MainActivity)
}
}
DiditSdk.startVerification(token = sessionToken) { result ->
when (result) {
is VerificationResult.Completed -> refreshAgeDecision() // asks your server
is VerificationResult.Cancelled -> keepSafeDefault()
is VerificationResult.Failed -> keepSafeDefault()
}
}
O resultado do SDK destina-se à interface. Obtenha a decisão a partir do webhook assinado status.updated ou leia GET /v3/session/{sessionId}/decision/ a partir do seu servidor.[25][29] Mantenha a predefinição de segurança em caso de cancelamento e de falha.
Conheça os limites
Onde o sinal for suficiente, ignore este passo. Uma verificação própria nem sempre é a melhor solução. As leis do Alabama e do Utah, com obrigações a partir de 2027, utilizam a categoria de idade mais baixa para as proteções que abrangem, e o Brasil, a alternativa mais protetora; logo, aí uma verificação só pode restringir mais.[22][23][24] As pessoas abrangidas pelas leis do Illinois, do Texas ou do Colorado necessitam da etapa de consentimento biométrico antes de uma selfie, algo que o SDK nativo 4.10.0 ou posterior pode apresentar.[28] Confirme com o departamento jurídico qual é a regra aplicável à sua aplicação.
Como a Didit ajuda após o sinal
Didit Age Estimation estima a idade a partir de uma selfie, com prova de vida no mesmo passo, e não revela quem é a pessoa. Um fluxo de trabalho pode enviar uma faixa limítrofe definida por si para uma verificação de documento.[27] O Age Estimation custa $0.10 por chamada; consulte os preços.

O resultado da estimativa da idade na consola da Didit (dados de exemplo): a estimativa a partir da selfie ao lado da idade no documento.
Existem SDK nativos para Android, iOS, React Native e Flutter. Para o Unity e outros motores, a via documentada é a integração por WebView.[31] As superfícies fora do Google Play são abordadas em API de verificação da idade: aplicações, web e lojas e na página de soluções de verificação da idade.
A Didit fornece
- Uma verificação da idade alojada com selfie, prova de vida e um passo opcional de documento
- Uma opção de fluxo de trabalho ISO/IEC 27566-1 que devolve uma decisão de sim ou não sobre a idade e sem dados pessoais, a partir de uma idade mínima de 13[27]
- Janelas de retenção, seletores de dados devolvidos e uma chamada de eliminação[30]
Fica consigo
- A chamada da Play Age Signals e o respetivo resultado
- Qual a lei aplicável e se é necessária qualquer verificação
- A predefinição adequada à idade e a decisão final de acesso
A Didit não tem um conector para a Play Age Signals: o sinal permanece na sua aplicação.
Veja o ramo de contingência em execução na sua aplicação
Traga a sua barreira de idade, os seus mercados e as suas tecnologias, ou crie o fluxo de trabalho por si.
Principais conclusões
- Utilize a 0.0.6: chamada opcional de funcionalidades, pedido de acesso e, em seguida,
checkAgeSignalsapenas emSHARED. - Condicione o acesso com base em
ageLower; umageUppernulo significa a faixa superior, e idades personalizadas podem fazer com que essa faixa comece abaixo dos 18. - Limites nulos,
UNSPECIFIEDe erros correspondem a ausência de sinal, nunca a um adulto. - O manifesto da 0.0.6 declara minSdk 24.
- Mantenha o sinal na sua aplicação e inicie qualquer verificação própria sem ele.
Perguntas frequentes
Que versão da Play Age Signals API devo utilizar?
Utilize a 0.0.6. É a versão atual, disponível globalmente, e a Google afirma que devolverá respostas para todos os utilizadores até 11 de dezembro de 2026; entretanto, a 0.0.4 continua a devolver respostas em regiões selecionadas.[2]
É necessário chamar getApplicableAgeFeatures?
Não, a Google marca-a como opcional. Chame-a quando os seus próprios ecrãs tiverem de ser diferentes para um utilizador cuja partilha é obrigatória.[2]
Qual é a diferença entre NOT_SHARED e VERIFICATION_REQUIRED?
NOT_SHARED significa que a sua aplicação não recebe nenhum sinal de idade porque o utilizador ou o progenitor não concordou com a partilha. VERIFICATION_REQUIRED significa que a idade não foi verificada numa região onde tanto a verificação como a partilha são obrigatórias, e a Google indica que deve pedir ao utilizador para aceder à Play Store.[2]
Porque é que ambos os limites são nulos?
A referência de resposta fornece limites nulos quando o estado é NOT_SHARED ou VERIFICATION_REQUIRED.[3] Trate os limites nulos como ausência de sinal e nunca como um adulto.
Por que razão ageUpper é nulo para adultos?
Porque a faixa superior é aberta: 18+ devolve ageLower 18 e ageUpper nulo.[3] Com idades personalizadas, a faixa superior pode começar mais abaixo; por isso, compare ageLower com a sua própria idade mínima.
Posso definir as minhas próprias faixas etárias?
Sim, até três idades mínimas na página Sinais de idade na Play Console, com pelo menos dois anos de intervalo, alteráveis uma vez por ano. Elas substituem as faixas predefinidas.[3]
Como posso testar antes de a lei entrar em vigor?
Utilize FakeAgeSignalsManager para devolver qualquer estado, faixa ou erro, incluindo MANDATORY_SHARING. Uma conta de testador de licenças permite que uma versão de depuração instalada lateralmente chame a API real.[6]
Funciona numa Trusted Web Activity ou numa WebView?
Não a partir de código web. É uma biblioteca Android chamada com uma Activity, e as páginas da Google que consultámos não documentam qualquer interface web. Uma aplicação de invólucro necessitaria do seu próprio código nativo, e os termos da Google limitam a informação à aplicação requerente.[2][5]
Existe algum plugin para Unity, Flutter ou React Native?
Existem pacotes da comunidade e de frameworks. Os que verificámos a 22 de novembro de 2026 declaram 0.0.4, pelo que carecem de getApplicableAgeFeatures. A equipa da Unity afirmou em dezembro de 2025 que a Unity não lançaria um plugin dedicado.[17][18][19][20][21]
Posso armazenar o resultado no meu servidor?
As páginas da Google descrevem expressamente o armazenamento de installId no seu servidor para notificações de revogação. Quanto ao resto, guarde o menor resultado que o seu dever legal exigir, dentro dos seus próprios sistemas, e nunca em ferramentas de analítica, publicidade ou num serviço de terceiros, a menos que a lei o exija estritamente.[9][13]
Fontes
- Use Play Age Signals API (beta), Android Developers, atualizado a 19 de novembro de 2026.
- Request age signals, Android Developers, atualizado a 18 de novembro de 2026.
- Understand age signals responses, Android Developers, atualizado a 18 de novembro de 2026.
- Play Age Signals release notes, Android Developers, atualizado a 19 de novembro de 2026.
- Play Age Signals overview and terms of service, Android Developers, atualizado a 18 de novembro de 2026.
- Test your Play Age Signals API (beta) integration, Android Developers, atualizado a 19 de novembro de 2026.
- Play Age Signals API error code reference, Android Developers, atualizado a 18 de novembro de 2026.
- Notify Google Play of significant changes, Android Developers, atualizado a 4 de setembro de 2026.
- Review revoked app approvals, Android Developers, atualizado a 4 de setembro de 2026.
- AgeRangeSource reference, Android Developers, atualizado a 18 de novembro de 2026.
- com.google.android.play:age-signals, Google Maven; manifestos da biblioteca e classes das versões 0.0.3, 0.0.4 e 0.0.6 consultados a 22 de novembro de 2026.
- Use Play Age Signals API, version 0.0.3, Android Developers, atualizado a 23 de outubro de 2026.
- Age Signals API and User Data policy, Google Play Console Help.
- About age range sharing on Google Play, Google Play Help.
- AB 1856, Chapter 184, Statutes of 2026, California Legislative Information; altera o Código Civil, artigos 1798.500 a 1798.504.
- Regional age-related protections on Play, Android Developers, atualizado a 18 de novembro de 2026.
- Expo AgeRange, documentação da Expo; pacote expo-age-range 58.0.3.
- age_range_signals, pub.dev, versão 0.10.1 de 6 de outubro de 2026.
- react-native-play-age-range-declaration, GitHub, versão 3.0.5.
- unity-play-age-signals, GitHub, atualizado a 4 de agosto de 2026.
- Play Age Signals API Support, Unity Discussions, resposta da equipa da Unity de dezembro de 2025.
- Code of Alabama 8-19K-9 (HB 161), Alabama Legislature.
- Utah Code 13-76-202, Utah Legislature; deveres dos programadores a partir de 6 de maio de 2027.
- Decreto 12.880 de 18 de março de 2026, art. 25, Planalto, Brasil.
- Create session, documentação da Didit.
- Android SDK, documentação da Didit.
- Visão geral da estimativa da idade, documentação da Didit.
- Consentimento biométrico, documentação da Didit.
- Webhooks, documentação da Didit.
- Retenção de dados, documentação da Didit.
- Visão geral dos SDK nativos, documentação da Didit.
- Referência da FakeAgeSignalsManager, Android Developers, atualizado a 18 de novembro de 2026.
Implemente as três chamadas, teste cada linha da tabela e mantenha o sinal onde os termos da Google o deixam: na sua aplicação. Para os ramos a que não consegue responder, adicione a estimativa da idade como verificação própria.
Adicione a verificação para utilizadores sem sinal
Peça uma demonstração da estimativa da idade na sua aplicação ou crie um fluxo de trabalho e inicie uma sessão hoje.
Artigos relacionados
- Google Play Age Signals API: what changes in January 2027
- Age assurance for apps: games, social, dating, AI and more
- Age verification API: which one works on apps, web and stores
- Brazil's ECA Digital and Google Play: age signals in your app
- California age verification law 2027: the four rules for apps
- App Store Accountability Acts: Texas, Utah, Louisiana, Alabama