Pular para o conteúdo principal
Didit levanta US$ 7,5 milhões para construir a infraestrutura para identidade e fraude
Didit
Voltar para o blog
Blog · 22 de novembro de 2026

Guia de integração da Play Age Signals API: v0.0.6 para apps Android

As três chamadas da Play Age Signals 0.0.6 em Kotlin, tabela de decisão para cada status, nível e limite, erros, migração da 0.0.3 e 0.0.4, testes e como iniciar sua própria verificação de idade.

Por DiditAtualizado
play-age-signals-api-integration-cover.png

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 status for SHARED.[1][2]

  • Leia a idade em ageLower. O nível indica como a idade foi estabelecida, e nulo nunca significa adulto.
  • O manifesto da biblioteca 0.0.6 declara minSdk 24, embora o guia indique API 23.[1][11]
  • O sinal permanece no seu aplicativo. Se você precisar da sua própria verificação de idade, inicie-a sem o sinal.

Última revisão: 22 de novembro de 2026 · Não constitui assessoria jurídica

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. O Google oferece a API e não obriga você a chamá-la; uma lei pode obrigar.

Cada classe, método e enum abaixo foi verificado em 22 de novembro de 2026 com base nas páginas do Google e na biblioteca 0.0.6 publicada; o código Kotlin para o sinal compila com ela.

O que você precisa

A API funciona em celulares, dobráveis e tablets, por meio do aplicativo da Play Store no dispositivo.[1][5]

  • Defina minSdk como 24 (consulte o aviso).
  • Distribua pelo Google Play: os termos limitam a API a aplicativos que o Google Play atualiza.[5]
  • Abra a página Sinais de idade no Play Console: idades personalizadas, alterações significativas e aprovações revogadas ficam lá.[3][8][9]
  • Preencha o formulário de segurança dos dados do Play você mesmo. O Google afirma que a biblioteca de cliente não coleta dados e que o preenchimento do formulário é sua decisão.[5]

Atenção

A página de configuração do Google indica Android 6.0, nível 23 da API.[1] O manifesto dentro da biblioteca 0.0.6 declara minSdkVersion 24; 0.0.3 e 0.0.4 declaravam 23.[11] Um aplicativo com minSdk 23 pode parar de compilar na mesclagem de manifestos após a atualização. Aumentar para 24 é a correção simples.

  1. Fevereiro de 20260.0.3Uma chamada, userStatus, adiciona DECLARED.
  2. Julho de 20260.0.4Duas chamadas, níveis substituem userStatus.
  3. Novembro de 20260.0.6Global, adiciona getApplicableAgeFeatures.
  4. 11 de dezembro de 2026Todos os usuáriosData do Google para respostas a todos.

Versões da biblioteca, a partir das notas de versão e do banner do Google.[2][4] Até essa data, espere que alguns usuários não recebam resposta.

Adicione a biblioteca

Uma dependência.[1] O gerenciador simulado para testes está no mesmo artefato.[11]

dependencies {
    implementation("com.google.android.play:age-signals:0.0.6")
}

1getApplicableAgeFeatures (opcional)

Se o compartilhamento é obrigatório para este usuário.

2requestAgeSignalsAccess

Pode exibir o aviso próprio do Google Play.

O status é SHARED

Sim

3checkAgeSignals

Leia limites, origem, status de alteração.

Não

Nenhuma idade vinda do Google

Use seu padrão adequado à idade.

A ordem de chamadas na versão 0.0.6.[2]

Etapa 1: o compartilhamento é obrigatório para este usuário

A chamada é opcional.[2] features() contém MANDATORY_SHARING apenas para usuários em regiões cujas leis exigem que lojas de aplicativos compartilhem informações de idade, e fica vazio para todos os demais.[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) }

Observação

Obrigatório significa que o compartilhamento por parte do usuário é obrigatório. Isso não diz nada sobre como a idade foi estabelecida: o Google documenta MANDATORY_SHARING com TIER_A, TIER_B, TIER_C e TIER_D.[3]

Etapa 2: solicitar acesso

O texto do Google descreve requestAgeSignalsAccess(Activity); o método recebe um AgeSignalsAccessRequest que transporta a Activity.[2] Chame-o onde um aviso for aceitável.

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 usuário vê depende da região e da configuração:[2]

UsuárioAvisoStatus
Estado dos EUA onde as lojas devem fornecer idades verificadas; usuário verificado ou supervisionadoNenhumSHARED
Mesmo caso, ainda não verificadoNenhum no seu aplicativo; o Play cuida dissoVERIFICATION_REQUIRED
Em outras regiões, Perguntar antes de compartilhar (o padrão[14])Aviso do Play no seu aplicativoSHARED ou NOT_SHARED
Em outras regiões, Sempre compartilharNenhumSHARED
Em outras regiões, Nunca compartilharNenhumNOT_SHARED
Em outras regiões, supervisionadoNenhum; o responsável decide no Family LinkSHARED ou NOT_SHARED

Após o usuário fechar o aviso algumas vezes, o Play deixa de exibi-lo; portanto, não chame em loop.[2] Onde o compartilhamento é obrigatório, a configuração fica fixada em Sempre compartilhar.[14]

Mapeie seu controle de idade para o sinal

Mostre-nos seu controle de idade e seus mercados, e mostraremos quais ramificações precisam de verificação própria e quais não precisam.

Agende uma demonstraçãoComece grátis

Etapa 3: leia o resultado

Todos os campos aceitam valor nulo, portanto converta uma vez e mantenha um único tipo no seu aplicativo. 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 status, origem e alteração são números inteiros onde 0 é UNSPECIFIED.[10][11] Trate isso em um bloco else. O guia 0.0.3 do Google recomendou uma nova solicitação quando o aplicativo for aberto porque os valores mudam[12]; o usuário também pode desativar o compartilhamento mais tarde.[14]

Observação

Esse guia também recomenda chamar a Play Integrity API em conjunto, para que a chamada venha de uma compilação não adulterada em um dispositivo certificado.[12] O sinal é uma resposta do lado do cliente: não confie em uma faixa que um cliente modificado envie ao seu servidor.

A tabela de decisão: status x origem x limites

As faixas padrão são 0-12, 13-15, 16-17 e 18+.[3] A última coluna é nossa recomendação de engenharia, não do Google.

StatusOrigemInferior / superiorO que significaO que seu código faz
ExceçãonenhumnenhumSem resposta[7]Tente novamente se o erro permitir repetição; caso contrário, trate como ausência de sinal
NOT_SHAREDnullnull / nullO usuário ou o responsável não concordou em compartilhar[2][3]Padrão apropriado para a idade, sem nova solicitação
VERIFICATION_REQUIREDnullnull / nullNão verificado, em uma região onde a verificação e o compartilhamento são obrigatórios[2][3]Direcione para a Play Store, mantenha o padrão
SHAREDTIER_A13 / 15O usuário informou a idade ao Google, que pode ou não tê-la confirmado[3]Aplique a faixa
SHAREDTIER_A18 / nullO mesmo, faixa adulta[3]Aplique-a; adicione uma verificação apenas se a lei ou o risco exigir mais
SHAREDTIER_B13 / 15Idade gerenciada por um dos pais ou responsável[3]Aplique a faixa, leia o status de alteração
SHAREDTIER_C18 / nullAvaliada por cartão de crédito, e-mail, selfie, documento oficial de identidade ou identificador fiscal[3]Aplique a faixa
SHAREDTIER_D18 / nullDocumento oficial de identidade com selfie, ou uma identidade digital[3]Aplique a faixa
SHAREDqualquernull / qualquerNão está na tabela de respostas do GoogleTrate como ausência de sinal

Três interpretações causam a maioria dos erros:

  • TIER_A não é "não verificado". Um adulto que se verificou com uma identidade digital mas compartilha por opção também chega como TIER_A.[3] TIER_C e TIER_D são retornados apenas em regiões onde a verificação de idade é obrigatória, por exemplo no Texas.[3] A referência da classe rotula TIER_A como "autodeclarado"; o guia de respostas é mais cauteloso.[3][10]
  • TIER_B não é uma idade. Ele indica quem a gerencia. Leia os limites.
  • Limites nulos não são um adulto verificado. Um comentário no exemplo em Java do Google sugere isso; o exemplo em Kotlin diz que o usuário não está compartilhando, e a tabela de respostas concorda com o Kotlin.[2][3]

Quando parar por aqui

Se a faixa responder à sua pergunta e nenhuma lei ou risco exigir mais, pare. Uma segunda verificação para cada usuário é difícil de conciliar com a minimização de dados, e na Califórnia o sinal é o indicador principal, a menos que você tenha informações internas claras e convincentes.[15]

Quando uma ramificação termina sem sinal, o desenho do que vem a seguir está em o que fazer em caso de NOT_SHARED, TIER_A ou sem resposta.

Precisa de uma resposta onde o sinal não oferece nenhuma

Agende uma demonstração de estimativa de idade no seu aplicativo: selfie primeiro, documento apenas para casos limítrofes.

Agende uma demonstraçãoComece grátis

Idades mínimas personalizadas

Na aba Faixas etárias personalizadas você insere até três idades mínimas, com pelo menos dois anos de intervalo, que podem ser alteradas uma vez por ano. Elas substituem a resposta padrão.[3]

Idades mínimas definidasFaixas retornadasFaixa superior
Nenhuma (padrão)0-12, 13-15, 16-17, 18+18 / null
150-14, 15+15 / null
13, 170-12, 13-16, 17+17 / null
11, 13, 150-10, 11-12, 13-14, 15+15 / null

Exemplos do guia de respostas do Google.[3]

Exemplo

Você define 13 e 17. Uma pessoa de 25 anos agora retorna 17 / null, o mesmo que uma de 17 anos. O código que interpreta um ageUpper nulo como adulto permite que pessoas de 17 anos acessem um recurso para maiores de 18 anos; portanto, mantenha 18 na sua lista se você aplica o limite de 18. Os limites documentados param em 18[3]: esta API não pode atender a uma restrição de 21 anos.

Alterações significativas e aprovações revogadas

Ambos os recursos são para usuários supervisionados. Qual lei torna uma alteração significativa é uma decisão sua, não do Play[8]; as regras estaduais estão em App Store Accountability Acts.

Você notifica o 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, exibida literalmente aos pais
  • significantChangeStatus é APPROVED, PENDING ou DECLINED
  • Seu aplicativo deve restringir o recurso alterado

Cumulativo: uma aprovação cobre todas as alterações pendentes[8]

O Play notifica você

Aprovação revogada

  • O installId é por usuário e dispositivo, e não sobrevive a uma redefinição
  • Você pode armazená-lo em seu back-end apenas para essa finalidade
  • IDs revogados aparecem como um CSV no Play Console
  • Cada entrada é excluída após 90 dias, portanto faça o download de forma programada

Um ID pode aparecer mais de uma vez[9]

Restrinja o recurso alterado, não o aplicativo inteiro, em PENDING e DECLINED. O status é nulo para contas não supervisionadas e para contas supervisionadas sem alterações registradas.[3]

Erros e dispositivos incompatíveis

Falhas chegam como AgeSignalsException. O Google recomenda tentar novamente com um número máximo de tentativas.[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ódigoConstanteTentar novamenteAção
-1, -6API_NOT_AVAILABLE, PLAY_STORE_VERSION_OUTDATEDSimSolicite a atualização da Play Store
-2PLAY_STORE_NOT_FOUNDSimSolicite a instalação ou ativação da Play Store
-3NETWORK_ERRORSimSolicite a verificação da conexão
-4, -7PLAY_SERVICES_NOT_FOUND, PLAY_SERVICES_VERSION_OUTDATEDSimSolicite a instalação, ativação ou atualização do Play Services
-5CANNOT_BIND_TO_SERVICESimBackoff exponencial e, em seguida, atualizar a Play Store
-8CLIENT_TRANSIENT_ERRORSimTentativas com limite e, em seguida, tentar mais tarde
-9APP_NOT_OWNEDNãoNão instalado pelo Google Play: instalação fora da loja ou outra loja
-10SDK_VERSION_OUTDATEDNãoDistribua uma biblioteca mais recente
-11DEVICE_NOT_SUPPORTEDNãoTipo de dispositivo não atendido; novidade na 0.0.6[4]
-100INTERNAL_ERRORNãoO texto do Google ainda sugere tentativas limitadas; o código acima não tenta novamente

Referência de códigos de erro do Google.[7] Um erro não é uma idade: recorra à experiência padrão.

Migrar da 0.0.3 e 0.0.4

A versão 0.0.3 ainda retorna respostas, mas não recebe atualizações.[12] Migrar a partir dela exige reescrever o caminho de leitura; a partir da 0.0.4, a mudança é pequena.

No seu códigoNa 0.0.6De
Apenas checkAgeSignalsrequestAgeSignalsAccess primeiro[4]0.0.3
userStatus()Removidos: ageRangeSource() e significantChangeStatus()[4]0.0.3
VERIFIEDTIER_C ou TIER_D (nossa leitura)0.0.3
DECLAREDTIER_A, ou TIER_B se um responsável a gerencia (nossa leitura)0.0.3
SUPERVISEDTIER_B (nossa leitura)0.0.3
SUPERVISED_APPROVAL_PENDING, SUPERVISED_APPROVAL_DENIEDTIER_B com PENDING ou DECLINED (nossa leitura)0.0.3
UNKNOWN, nullO status de acesso: VERIFICATION_REQUIRED ou NOT_SHARED (nossa leitura)0.0.3
mostRecentApprovalDate()significantChangeApprovalDate()[4]0.0.3
Duas chamadas, níveisInalterado; adicione getApplicableAgeFeatures se for útil[4]0.0.4
Tratamento de errosAdicione DEVICE_NOT_SUPPORTED[4]Ambos
minSdk 23A biblioteca declara 24[11]Ambos

O Google não publica um mapeamento valor por valor. As linhas marcadas como "nossa leitura" resultam da comparação de ambas as definições.[3][12]

Atenção

As antigas constantes de AgeSignalsVerificationStatus ainda estão presentes na versão 0.0.6, portanto as importações compilam enquanto userStatus() não existe.[11] Na versão 0.0.3, VERIFIED era 0; na 0.0.6, 0 é UNSPECIFIED.[10][11] Limpe os inteiros em cache ao atualizar.

Teste com FakeAgeSignalsManager e testadores de licença

O FakeAgeSignalsManager nunca se comunica com a Play Store; sua referência o restringe a testes unitários e desenvolvimento inicial.[32] Injete o gerenciador 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 status, uma faixa de menor de idade, uma faixa de adulto, limites nulos e um erro por chamada (setNextRequestAgeSignalsAccessException e setNextApplicableAgeFeaturesException causam falha nas outras duas).
  • Execute a chamada real com um testador de licença: normalmente, um aplicativo não atualizado pelo Play recebe APP_NOT_OWNED; os testadores podem instalar uma versão de depuração fora da loja.[6]
  • Mantenha o nome do pacote idêntico ao do aplicativo no Play e faça login com a conta de testador.[6]

Flutter, React Native, Expo e Unity

Estes são pacotes da comunidade ou do framework, não do Google, e listar um pacote não constitui recomendação. Verifique a versão da biblioteca antes de enviar para produção.

TecnologiaPacote verificadoBibliotecaSaiba antes de publicar
Expoexpo-age-range 58.0.30.0.4Na web e no iOS anterior ao 26, retorna lowerBound: 18, como um adulto[17]
React Nativereact-native-play-age-range-declaration 3.0.50.0.4Também engloba outras lojas e a Apple[19]
Flutterage_range_signals 0.10.10.0.4Fluxo de duas chamadas, suporte a testadores de licença[18]
Unityunity-play-age-signals0.0.4GPL-3.0; os callbacks podem ser executados fora da thread principal[20]

Consultado em 22 de novembro de 2026 na página ou arquivo de build de cada pacote.[17][18][19][20] A equipe da Unity informou 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 possui getApplicableAgeFeatures nem DEVICE_NOT_SUPPORTED. Se precisar deles, crie uma pequena ponte nativa. A parte da Apple é comparada em Play Age Signals vs Apple Declared Age Range.

Não registre em log, não compartilhe nem crie perfis

Os termos do Google limitam a informação a experiências adequadas à idade em conformidade com as leis, no aplicativo solicitante.[5] A política proíbe publicidade, análise de dados, criação de perfis e a venda, compartilhamento ou transferência dos dados a qualquer terceiro, exceto quando estritamente exigido por lei.[13]

  • Mantenha faixas, níveis e o installId fora de logs, relatórios de falhas e eventos analíticos: essas ferramentas geralmente pertencem a terceiros.
  • Mantenha o resultado bruto em memória sempre que possível e armazene a decisão sobre o recurso em vez do nível.
  • Nunca anexe o sinal a um fornecedor de verificação de idade, incluindo a Didit.
  • Na Califórnia, não solicite aos usuários que alterem suas informações de idade e não compartilhe nenhum sinal com terceiros para finalidades que a legislação não exija.[15]
  • Consulte a assessoria jurídica antes de solicitar um sinal para cada usuário: a lei da Califórnia proíbe solicitações que nem ela nem outra lei aplicável exijam.[15]

Portanto, a mensagem “acesse a Play Store” pertence a VERIFICATION_REQUIRED, não a um usuário da Califórnia cuja faixa você coloque em dúvida. A página regional do 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] Os deveres da Califórnia estão no guia do Digital Age Assurance Act.

Após o sinal: inicie sua própria verificação

Seu aplicativo decide que uma verificação é necessária; a solicitação inclui um fluxo de trabalho e o seu ID de usuário, nunca a resposta do 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 o aplicativo 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 serve para a interface. Obtenha a decisão a partir do webhook assinado status.updated ou consulte GET /v3/session/{sessionId}/decision/ a partir do seu servidor.[25][29] Mantenha o padrão seguro em caso de cancelamento e falha.

Conheça os limites

Quando o sinal for suficiente, pule esta etapa. Uma verificação própria nem sempre prevalece. As leis do Alabama e de Utah, com obrigações a partir de 2027, usam a faixa etária mais baixa para as proteções abrangidas, e o Brasil adota a alternativa mais protetiva, de modo que, nesses locais, uma verificação só pode restringir ainda mais.[22][23][24] As pessoas cobertas pelas leis de Illinois, Texas ou Colorado precisam da etapa de consentimento biométrico antes de uma selfie, que o SDK nativo 4.10.0 ou posterior pode exibir.[28] Confirme com a assessoria jurídica qual regra se aplica ao seu aplicativo.

Como a Didit ajuda após o sinal

Didit Age Estimation estima a idade a partir de uma selfie, com prova de vida na mesma etapa, e não revela quem a pessoa é. Um fluxo de trabalho pode encaminhar uma faixa limítrofe definida por você para uma verificação de documento.[27] O Age Estimation custa US$ 0,10 por chamada; consulte os preços.

Didit console, age estimation result of a verification: the estimated age from the selfie next to the age on the document

O resultado da estimativa de idade no console da Didit (dados de exemplo): a estimativa a partir da selfie ao lado da idade no documento.

Existem SDKs nativos para Android, iOS, React Native e Flutter. Para Unity e outros motores, o caminho documentado é a integração via WebView.[31] As interfaces fora do Google Play são abordadas em API de verificação de idade: aplicativos, web e lojas e na página de soluções de verificação de idade.

A Didit oferece

  • Uma verificação de idade hospedada com selfie, prova de vida e uma etapa opcional com documento
  • Uma opção de fluxo de trabalho ISO/IEC 27566-1 que retorna uma decisão de sim ou não sobre a idade e nenhum dado pessoal, a partir de uma idade mínima de 13 anos[27]
  • Janelas de retenção, controles de dados retornados e uma chamada de exclusão[30]

Fica sob sua responsabilidade

  • A chamada da Play Age Signals e seu resultado
  • Qual lei se aplica e se uma verificação é realmente necessária
  • O padrão adequado à idade e a decisão final de acesso

A Didit não possui um conector para a Play Age Signals: o sinal permanece no seu aplicativo.

Veja a ramificação alternativa em execução no seu aplicativo

Traga seu controle de idade, seus mercados e suas tecnologias, ou crie o fluxo de trabalho você mesmo.

Agende uma demonstraçãoComece grátisLeia a documentação

Principais conclusões

  • Use a 0.0.6: chamada opcional de recursos, solicitação de acesso e, depois, checkAgeSignals somente em SHARED.
  • Faça o controle por ageLower; um ageUpper nulo significa a faixa superior, e idades personalizadas podem deslocar essa faixa para abaixo de 18.
  • Limites nulos, UNSPECIFIED e erros significam ausência de sinal, nunca um adulto.
  • O manifesto da 0.0.6 declara minSdk 24.
  • Mantenha o sinal no seu aplicativo e inicie qualquer verificação própria sem ele.

Perguntas frequentes

Qual versão da Play Age Signals API devo usar?

Use a 0.0.6. É a versão atual, disponível globalmente, e o Google afirma que ela retornará respostas para todos os usuários até 11 de dezembro de 2026; enquanto isso, a 0.0.4 continua retornando respostas em regiões selecionadas.[2]

Preciso chamar getApplicableAgeFeatures?

Não, o Google a classifica como opcional. Chame-a quando suas próprias telas precisarem ser diferentes para um usuário cujo compartilhamento é obrigatório.[2]

Qual é a diferença entre NOT_SHARED e VERIFICATION_REQUIRED?

NOT_SHARED significa que seu aplicativo não recebe nenhum sinal de idade porque o usuário ou o responsável não concordou em compartilhar. VERIFICATION_REQUIRED significa que a idade não foi verificada em uma região onde tanto a verificação quanto o compartilhamento são obrigatórios, e o Google orienta a pedir ao usuário que acesse a Play Store.[2]

Por que ambos os limites são nulos?

A referência de resposta fornece limites nulos quando o status é NOT_SHARED ou VERIFICATION_REQUIRED.[3] Trate limites nulos como ausência de sinal, e nunca como um adulto.

Por que ageUpper é nulo para adultos?

Porque a faixa superior é aberta: 18+ retorna ageLower 18 e ageUpper nulo.[3] Com idades personalizadas, a faixa superior pode começar mais abaixo, portanto compare ageLower com a sua própria idade mínima.

Posso definir minhas próprias faixas etárias?

Sim, até três idades mínimas na página Sinais de idade no Play Console, com pelo menos dois anos de diferença entre elas, alteráveis uma vez por ano. Elas substituem as faixas padrão.[3]

Como testar antes que a lei se aplique?

Use o FakeAgeSignalsManager para retornar qualquer status, faixa ou erro, incluindo MANDATORY_SHARING. Uma conta de testador de licença permite que uma compilação de depuração instalada fora da loja chame a API real.[6]

Funciona em uma Trusted Web Activity ou em uma WebView?

Não a partir de código web. É uma biblioteca Android chamada com uma Activity, e as páginas do Google que consultamos não documentam nenhuma interface web. Um aplicativo encapsulador precisaria de seu próprio código nativo, e os termos do Google limitam as informações ao aplicativo solicitante.[2][5]

Existe um plugin para Unity, Flutter ou React Native?

Existem pacotes da comunidade e de frameworks. Aqueles que verificamos em 22 de novembro de 2026 declaram a versão 0.0.4, portanto não possuem getApplicableAgeFeatures. A equipe 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 do Google descrevem expressamente o armazenamento do installId no seu back-end para avisos de revogação. Quanto ao restante, mantenha o menor resultado que seu dever legal exigir, dentro dos seus próprios sistemas, e nunca em ferramentas de análise de dados, publicidade ou serviços de terceiros, a menos que a lei exija estritamente.[9][13]

Fontes

  1. Usar a Play Age Signals API (beta), Android Developers, atualizado em 19 de novembro de 2026.
  2. Solicitar sinais de idade, Android Developers, atualizado em 18 de novembro de 2026.
  3. Entender as respostas dos sinais de idade, Android Developers, atualizado em 18 de novembro de 2026.
  4. Notas de versão da Play Age Signals, Android Developers, atualizado em 19 de novembro de 2026.
  5. Visão geral e termos de serviço da Play Age Signals, Android Developers, atualizado em 18 de novembro de 2026.
  6. Testar sua integração com a Play Age Signals API (beta), Android Developers, atualizado em 19 de novembro de 2026.
  7. Referência de códigos de erro da Play Age Signals API, Android Developers, atualizado em 18 de novembro de 2026.
  8. Notificar o Google Play sobre alterações significativas, Android Developers, atualizado em 4 de setembro de 2026.
  9. Revisar aprovações de aplicativos revogadas, Android Developers, atualizado em 4 de setembro de 2026.
  10. Referência de AgeRangeSource, Android Developers, atualizado em 18 de novembro de 2026.
  11. com.google.android.play:age-signals, Google Maven; manifestos de biblioteca e classes das versões 0.0.3, 0.0.4 e 0.0.6 consultados em 22 de novembro de 2026.
  12. Usar a Play Age Signals API, versão 0.0.3, Android Developers, atualizado em 23 de outubro de 2026.
  13. Age Signals API e política de dados do usuário, Ajuda do Google Play Console.
  14. Sobre o compartilhamento de faixa etária no Google Play, Ajuda do Google Play.
  15. AB 1856, Chapter 184, Statutes of 2026, California Legislative Information; altera o Civil Code 1798.500 a 1798.504.
  16. Proteções regionais relacionadas à idade no Play, Android Developers, atualizado em 18 de novembro de 2026.
  17. Expo AgeRange, documentação do Expo; pacote expo-age-range 58.0.3.
  18. age_range_signals, pub.dev, versão 0.10.1 de 6 de outubro de 2026.
  19. react-native-play-age-range-declaration, GitHub, versão 3.0.5.
  20. unity-play-age-signals, GitHub, atualizado em 4 de agosto de 2026.
  21. Play Age Signals API Support, Unity Discussions, resposta da equipe da Unity de dezembro de 2025.
  22. Code of Alabama 8-19K-9 (HB 161), Legislatura do Alabama.
  23. Utah Code 13-76-202, Legislatura de Utah; obrigações dos desenvolvedores a partir de 6 de maio de 2027.
  24. Decreto 12.880 de 18 de março de 2026, art. 25, Planalto, Brasil.
  25. Criar sessão, documentação da Didit.
  26. Android SDK, documentação da Didit.
  27. Visão geral do Age Estimation, documentação da Didit.
  28. Consentimento biométrico, documentação da Didit.
  29. Webhooks, documentação da Didit.
  30. Retenção de dados, documentação da Didit.
  31. Visão geral dos SDKs nativos, documentação da Didit.
  32. Referência do FakeAgeSignalsManager, Android Developers, atualizado em 18 de novembro de 2026.

Implemente as três chamadas, teste cada linha da tabela e mantenha o sinal onde os termos do Google determinam: no seu aplicativo. Para as ramificações que ele não puder responder, adicione a estimativa de idade como sua própria verificação.

Adicione a verificação para usuários sem sinal

Agende uma demonstração da estimativa de idade no seu aplicativo ou crie um fluxo de trabalho e inicie uma sessão hoje mesmo.

Agende uma demonstraçãoComece grátis

Infraestrutura para identidade e fraude.

Uma API para KYC, KYB, Monitoramento de Transações e Análise de Carteiras. Integre em 5 minutos.

Peça para uma IA resumir esta página