Saltar para o conteúdo principal
Didit angaria 7,5 milhões de dólares para construir a infraestrutura para identidade e fraude
Didit
Voltar ao blog
Blog · 22 de novembro de 2026

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.

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

Última revisão: 22 de novembro de 2026 · Não constitui aconselhamento jurídico

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 minSdk como 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.

  1. fevereiro de 20260.0.3Uma chamada, userStatus, adiciona DECLARED.
  2. julho de 20260.0.4Duas chamadas, os níveis substituem userStatus.
  3. novembro de 20260.0.6Global, adiciona getApplicableAgeFeatures.
  4. 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

Sim

3checkAgeSignals

Ler limites, origem e estado da alteração.

Nã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]

UtilizadorPedidoEstado
Estado dos EUA onde as lojas têm de fornecer idades verificadas; utilizador verificado ou supervisionadoNenhumSHARED
O mesmo, ainda não verificadoNenhum na sua aplicação; a Play trata dissoVERIFICATION_REQUIRED
Noutros locais, Perguntar antes de partilhar (a predefinição[14])Pedido da Play dentro da aplicaçãoSHARED ou NOT_SHARED
Noutros locais, Partilhar sempreNenhumSHARED
Noutros locais, Nunca partilharNenhumNOT_SHARED
Noutros locais, supervisionadoNenhum; o progenitor decide no Family LinkSHARED 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.

Pedir uma demonstraçãoComeçar grátis

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.

EstadoOrigemInferior / superiorO que significaO que o seu código faz
ExceçãonenhumnenhumSem resposta[7]Tentar novamente se o erro for repetível; caso contrário, sem sinal
NOT_SHAREDnullnull / nullO utilizador ou o progenitor não concordou em partilhar[2][3]Predefinição adequada à idade, sem novo pedido
VERIFICATION_REQUIREDnullnull / nullNã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
SHAREDTIER_A13 / 15O utilizador forneceu a idade à Google, que pode tê-la confirmado ou não[3]Aplique a faixa etária
SHAREDTIER_A18 / nullIgual, faixa etária de adultos[3]Aplique-o; adicione uma verificação apenas se a lei ou o risco exigirem mais
SHAREDTIER_B13 / 15Idade gerida por um progenitor ou tutor[3]Aplique a faixa etária, leia o estado da alteração
SHAREDTIER_C18 / nullAvaliado 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
SHAREDTIER_D18 / nullDocumento de identificação oficial mais selfie, ou uma identificação digital[3]Aplique a faixa etária
SHAREDqualquernull / qualquerNão consta na tabela de respostas da GoogleTratar 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.

Pedir uma demonstraçãoComeçar grátis

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 configuradasIntervalos devolvidosFaixa superior
Nenhuma (predefiniçã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 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ódigoConstanteTentar novamenteAção
-1, -6API_NOT_AVAILABLE, PLAY_STORE_VERSION_OUTDATEDSimPedir para atualizar a Play Store
-2PLAY_STORE_NOT_FOUNDSimPedir para instalar ou ativar a Play Store
-3NETWORK_ERRORSimPedir para verificar a ligação
-4, -7PLAY_SERVICES_NOT_FOUND, PLAY_SERVICES_VERSION_OUTDATEDSimPedir para instalar, ativar ou atualizar os Play Services
-5CANNOT_BIND_TO_SERVICESimEspera exponencial entre tentativas, depois atualizar a Play Store
-8CLIENT_TRANSIENT_ERRORSimTentativas limitadas, depois tentar mais tarde
-9APP_NOT_OWNEDNãoNão instalada pelo Google Play: instalação lateral ou outra loja
-10SDK_VERSION_OUTDATEDNãoDistribua uma versão mais recente da biblioteca
-11DEVICE_NOT_SUPPORTEDNãoTipo de dispositivo não suportado; novidade na 0.0.6[4]
-100INTERNAL_ERRORNãoO 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ódigoNa 0.0.6De
Apenas checkAgeSignalsPrimeiro requestAgeSignalsAccess[4]0.0.3
userStatus()Removidos: ageRangeSource() e significantChangeStatus()[4]0.0.3
VERIFIEDTIER_C ou TIER_D (a nossa interpretação)0.0.3
DECLAREDTIER_A, ou TIER_B se for gerido por um progenitor (a nossa interpretação)0.0.3
SUPERVISEDTIER_B (a nossa interpretação)0.0.3
SUPERVISED_APPROVAL_PENDING, SUPERVISED_APPROVAL_DENIEDTIER_B com PENDING ou DECLINED (a nossa interpretação)0.0.3
UNKNOWN, nullO estado de acesso: VERIFICATION_REQUIRED ou NOT_SHARED (a nossa interpretação)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

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 (setNextRequestAgeSignalsAccessException e setNextApplicableAgeFeaturesException fazem 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.

TecnologiaPacote verificadoBibliotecaSaiba antes de publicar
Expoexpo-age-range 58.0.30.0.4Na web e em versões do iOS anteriores à versão 26 devolve lowerBound: 18, tal como um adulto[17]
React Nativereact-native-play-age-range-declaration 3.0.50.0.4Também integra outras lojas e a Apple[19]
Flutterage_range_signals 0.10.10.0.4Fluxo de duas chamadas, suporte para testadores de licenças[18]
Unityunity-play-age-signals0.0.4GPL-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 installId fora 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.

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

Pedir uma demonstraçãoComeçar grátisLer a documentação

Principais conclusões

  • Utilize a 0.0.6: chamada opcional de funcionalidades, pedido de acesso e, em seguida, checkAgeSignals apenas em SHARED.
  • Condicione o acesso com base em ageLower; um ageUpper nulo significa a faixa superior, e idades personalizadas podem fazer com que essa faixa comece abaixo dos 18.
  • Limites nulos, UNSPECIFIED e 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

  1. Use Play Age Signals API (beta), Android Developers, atualizado a 19 de novembro de 2026.
  2. Request age signals, Android Developers, atualizado a 18 de novembro de 2026.
  3. Understand age signals responses, Android Developers, atualizado a 18 de novembro de 2026.
  4. Play Age Signals release notes, Android Developers, atualizado a 19 de novembro de 2026.
  5. Play Age Signals overview and terms of service, Android Developers, atualizado a 18 de novembro de 2026.
  6. Test your Play Age Signals API (beta) integration, Android Developers, atualizado a 19 de novembro de 2026.
  7. Play Age Signals API error code reference, Android Developers, atualizado a 18 de novembro de 2026.
  8. Notify Google Play of significant changes, Android Developers, atualizado a 4 de setembro de 2026.
  9. Review revoked app approvals, Android Developers, atualizado a 4 de setembro de 2026.
  10. AgeRangeSource reference, Android Developers, atualizado a 18 de novembro de 2026.
  11. 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.
  12. Use Play Age Signals API, version 0.0.3, Android Developers, atualizado a 23 de outubro de 2026.
  13. Age Signals API and User Data policy, Google Play Console Help.
  14. About age range sharing on Google Play, Google Play Help.
  15. AB 1856, Chapter 184, Statutes of 2026, California Legislative Information; altera o Código Civil, artigos 1798.500 a 1798.504.
  16. Regional age-related protections on Play, Android Developers, atualizado a 18 de novembro de 2026.
  17. Expo AgeRange, documentação da 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 a 4 de agosto de 2026.
  21. Play Age Signals API Support, Unity Discussions, resposta da equipa da Unity de dezembro de 2025.
  22. Code of Alabama 8-19K-9 (HB 161), Alabama Legislature.
  23. Utah Code 13-76-202, Utah Legislature; deveres dos programadores a partir de 6 de maio de 2027.
  24. Decreto 12.880 de 18 de março de 2026, art. 25, Planalto, Brasil.
  25. Create session, documentação da Didit.
  26. Android SDK, documentação da Didit.
  27. Visão geral da estimativa da idade, 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 SDK nativos, documentação da Didit.
  32. 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.

Pedir uma demonstraçãoComeçar grátis

Infraestrutura para identidade e fraude.

Uma API para KYC, KYB, Monitorização de Transações e Rastreio de Carteiras. Integre em 5 minutos.

Peça a uma IA para resumir esta página