Guia d'integració de Play Age Signals API: v0.0.6 per a apps d'Android
Les tres crides de Play Age Signals 0.0.6 en Kotlin, taula de decisió per a cada estat, tier i límit, errors, migració des de 0.0.3 i 0.0.4, proves i com iniciar la teva pròpia verificació d'edat.

En resum
Per integrar la Play Age Signals API avui, afegiu com.google.android.play:age-signals:0.0.6, crideu requestAgeSignalsAccess amb una Activity i crideu checkAgeSignals només quan l'estat sigui SHARED.[1][2]
- Llegiu l'edat a
ageLower. El nivell indica com es va establir l'edat, i null mai és un adult. - El manifest de la biblioteca 0.0.6 declara minSdk 24, tot i que la guia indica API 23.[1][11]
- El senyal es queda a la vostra aplicació. Si necessiteu la vostra pròpia comprovació d'edat, inicieu-la sense el senyal.
Aquesta és la guia d'enginyeria per a la Play Age Signals API: primer Android, després Flutter, React Native, Expo i Unity. Per saber qui està afectat i què comença el gener de 2027, llegiu Google Play Age Signals API: què canvia el gener de 2027. Google ofereix l'API i no us obliga a cridar-la; una llei us hi pot obligar.
Cada classe, mètode i enum següents es va comprovar el 22 de novembre de 2026 amb les pàgines de Google i la biblioteca 0.0.6 publicada; el codi Kotlin per al senyal compila contra aquesta.
Què necessiteu
L'API s'executa en telèfons, plegables i tauletes, a través de l'aplicació Play Store al dispositiu.[1][5]
- Establiu
minSdka 24 (vegeu l'avís). - Distribuïu a través de Google Play: les condicions limiten l'API a aplicacions que Google Play actualitza.[5]
- Obriu la pàgina Age signals a Play Console: les edats personalitzades, els canvis significatius i les aprovacions revocades es troben allà.[3][8][9]
- Responeu vosaltres mateixos al formulari de seguretat de les dades de Play. Google diu que la biblioteca client no recull cap dada i que la decisió sobre el formulari és vostra.[5]
Atenció
La pàgina de configuració de Google indica Android 6.0, nivell d'API 23.[1] El manifest dins de la biblioteca 0.0.6 declara minSdkVersion 24; 0.0.3 i 0.0.4 declaraven 23.[11] Una aplicació amb minSdk 23 pot deixar de compilar en la fusió de manifests després de l'actualització. Pujar-lo a 24 és la solució senzilla.
- febrer de 20260.0.3Una crida,
userStatus, afegeix DECLARED. - juliol de 20260.0.4Dues crides, els nivells substitueixen
userStatus. - novembre de 20260.0.6Global, afegeix
getApplicableAgeFeatures. - 11 de desembre de 2026Tots els usuarisData de Google perquè les respostes arribin a tothom.
Versions de la biblioteca, a partir de les notes de la versió i el bàner de Google.[2][4] Fins a aquesta data, compteu que alguns usuaris no tindran resposta.
Afegiu la biblioteca
Una dependència.[1] El gestor fals per a proves és en el mateix artefacte.[11]
dependencies {
implementation("com.google.android.play:age-signals:0.0.6")
}
1getApplicableAgeFeatures (opcional)
Indica si compartir és obligatori per a aquest usuari.
2requestAgeSignalsAccess
Pot mostrar l'avís propi de Google Play.
L'estat és SHARED
3checkAgeSignals
Llegiu els límits, la font i l'estat del canvi.
Cap edat de Google
Utilitzeu el valor predeterminat adequat per a l'edat.
L'ordre de les crides a la versió 0.0.6.[2]
Pas 1: la compartició és obligatòria per a aquest usuari?
La crida és opcional.[2] features() conté MANDATORY_SHARING només per a usuaris de regions on la legislació exigeix a les botigues d'aplicacions que comparteixin informació sobre l'edat, i està buit per a tota la resta.[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
Obligatori vol dir que la compartició per part de l'usuari és obligatòria. No diu res sobre com s'ha establert l'edat: Google documenta MANDATORY_SHARING amb TIER_A, TIER_B, TIER_C i TIER_D.[3]
Pas 2: demaneu accés
El text de Google escriu requestAgeSignalsAccess(Activity); el mètode accepta un AgeSignalsAccessRequest que conté l'Activity.[2] Crideu-lo quan mostrar un avís sigui acceptable.
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) }
El que veu l'usuari depèn de la regió i de la configuració:[2]
| Usuari | Avís | Estat |
|---|---|---|
| Estat dels EUA on les botigues han de proporcionar edats verificades, d'usuaris verificats o supervisats | Cap | SHARED |
| El mateix, encara no verificat | Cap dins de la vostra aplicació; Play se n'encarrega | VERIFICATION_REQUIRED |
| A altres llocs, Preguntar abans de compartir (opció predeterminada[14]) | Avís de Play dins de l'aplicació | SHARED o NOT_SHARED |
| A altres llocs, Compartir sempre | Cap | SHARED |
| A altres llocs, No compartir mai | Cap | NOT_SHARED |
| A altres llocs, supervisat | Cap; el progenitor decideix a Family Link | SHARED o NOT_SHARED |
Després d'uns quants rebutjos, Play deixa de mostrar l'avís, així que no feu la crida en bucle.[2] On compartir és obligatori, la configuració està fixada a Compartir sempre.[14]
Relacioneu el vostre control d'edat amb el senyal
Mostreu-nos el vostre control d'edat i els vostres mercats, i us mostrarem quines branques necessiten la vostra pròpia comprovació i quines no.
Pas 3: llegiu el resultat
Tots els camps admeten valors nuls, així que convertiu-los una vegada i manteniu un sol tipus a la vostra aplicació. Aquest mapatge llegeix l'edat només a partir dels límits.
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) }
}
Les constants d'estat, font i canvi són enters on 0 és UNSPECIFIED.[10][11] Gestioneu-ho en una branca else. La guia 0.0.3 de Google aconsellava fer una sol·licitud nova quan s'obre l'aplicació perquè els valors canvien[12]; un usuari també pot desactivar l'opció de compartir més endavant.[14]
Nota
Aquesta guia també recomana cridar la Play Integrity API en paral·lel, de manera que la crida provingui d'una versió no manipulada en un dispositiu certificat.[12] El senyal és una resposta del costat del client: no confieu en una franja que un client modificat enviï al vostre servidor.
La taula de decisió: estat x font x límits
Els intervals predeterminats són 0-12, 13-15, 16-17 i 18+.[3] La darrera columna és el nostre consell tècnic, no el de Google.
| Estat | Font | Inferior / superior | Què significa | Què fa el vostre codi |
|---|---|---|---|---|
| Excepció | cap | cap | Sense resposta[7] | Reintenteu si es pot reintentar; si no, cap senyal |
NOT_SHARED | null | null / null | L'usuari o el progenitor no han acceptat compartir[2][3] | Valor predeterminat adequat per a l'edat, sense repetir l'avís |
VERIFICATION_REQUIRED | null | null / null | No verificat, en una regió on la verificació i la compartició són obligatòries[2][3] | Redirigiu a la Play Store, manteniu el valor per defecte |
SHARED | TIER_A | 13 / 15 | L'usuari ha indicat l'edat a Google, que pot haver-la confirmat o no[3] | Apliqueu la franja |
SHARED | TIER_A | 18 / null | El mateix, franja d'adults[3] | Apliqueu-la; afegiu una comprovació només si la llei o el risc en demanen més |
SHARED | TIER_B | 13 / 15 | Edat gestionada per un progenitor o tutor[3] | Apliqueu la franja, llegiu l'estat del canvi |
SHARED | TIER_C | 18 / null | Avaluat mitjançant targeta de crèdit, correu electrònic, selfie, document d'identitat oficial o número d'identificació fiscal[3] | Apliqueu la franja |
SHARED | TIER_D | 18 / null | Document d'identitat oficial més selfie, o una identitat digital[3] | Apliqueu la franja |
SHARED | qualsevol | null / qualsevol | No figura a la taula de respostes de Google | Tracteu-ho com a absència de senyal |
Tres interpretacions causen la majoria dels errors:
- TIER_A no és «no verificat». Un adult que s'ha verificat amb una identitat digital però comparteix per elecció també arriba com a TIER_A.[3] TIER_C i TIER_D només es retornen en regions on la verificació d'edat és obligatòria, per exemple a Texas.[3] La referència de classes etiqueta TIER_A com a «autodeclarat»; la guia de respostes és més prudent.[3][10]
- TIER_B no és una edat. Indica qui la gestiona. Llegiu els límits.
- Els límits nuls no són un adult verificat. Un comentari a l'exemple de Java de Google ho suggereix; el seu exemple de Kotlin diu que l'usuari no comparteix, i la taula de respostes coincideix amb el de Kotlin.[2][3]
Quan aturar-se aquí
Si la franja respon a la vostra pregunta i cap llei o risc no exigeix més, atureu-vos. Una segona comprovació per a cada usuari és difícil de conciliar amb la minimització de dades, i a Califòrnia el senyal és l'indicador principal tret que disposeu d'informació interna clara i convincent.[15]
Quan una branca acaba sense senyal, el disseny del que ve després es troba a què fer en cas de NOT_SHARED, TIER_A o sense resposta.
Necessiteu una resposta quan el senyal no en té cap
Sol·liciteu una demo de l'estimació d'edat a la vostra aplicació: selfie primer, document només per a casos límit.
Edats mínimes personalitzades
A la pestanya Custom age ranges podeu introduir fins a tres edats mínimes, separades com a mínim per dos anys, que es poden canviar un cop l'any. Aquestes substitueixen la resposta predeterminada.[3]
| Edats mínimes definides | Intervals retornats | Franja superior |
|---|---|---|
| Cap (per defecte) | 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 |
Exemples de la guia de respostes de Google.[3]
Exemple
Configureu 13 i 17. Per a un usuari de 25 anys, ara es retorna 17 / null, igual que per a un de 17 anys. El codi que interpreta un ageUpper null com a adult deixa entrar usuaris de 17 anys en una funcionalitat per a usuaris de 18 anys o més, així que manteniu el 18 a la vostra llista si el vostre llindar és als 18. Els límits documentats arriben fins als 18[3]: aquesta API no pot respondre a un llindar de 21.
Canvis significatius i aprovacions revocades
Totes dues funcions són per a usuaris supervisats. Quina llei fa que un canvi sigui significatiu és decisió vostra, no de Play[8]; les normatives estatals es troben a App Store Accountability Acts.
Notifiqueu-ho a Play
Canvi significatiu
- Fins a 3 canvis, amb fins a 90 dies d'antelació, amb més de 2 dies de diferència
- Cal una descripció en anglès, que es mostra literalment als pares
significantChangeStatusés APPROVED, PENDING o DECLINED- La vostra aplicació ha de restringir la funcionalitat modificada
Acumulatiu: una aprovació cobreix tots els canvis pendents[8]
Play us notifica
Aprovació revocada
installIdés per usuari i dispositiu, i no sobreviu a un restabliment- Podeu emmagatzemar-lo al vostre servidor només per a aquesta finalitat
- Els ID revocats apareixen com un CSV a Play Console
- Cada entrada s'elimina al cap de 90 dies, per la qual cosa descarregueu-les periòdicament
Un mateix ID pot aparèixer més d'una vegada[9]
Restringiu la funcionalitat modificada, no tota l'aplicació, quan l'estat sigui PENDING o DECLINED. L'estat és null per als comptes no supervisats i per als supervisats sense cap canvi registrat.[3]
Errors i dispositius no compatibles
Els errors arriben com a AgeSignalsException. Google aconsella reintents amb un nombre màxim d'intents.[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)
}
| Codi | Constant | Reintent | Acció |
|---|---|---|---|
| -1, -6 | API_NOT_AVAILABLE, PLAY_STORE_VERSION_OUTDATED | Sí | Demaneu que s'actualitzi la Play Store |
| -2 | PLAY_STORE_NOT_FOUND | Sí | Demaneu que s'instal·li o s'activi la Play Store |
| -3 | NETWORK_ERROR | Sí | Demaneu que es comprovi la connexió |
| -4, -7 | PLAY_SERVICES_NOT_FOUND, PLAY_SERVICES_VERSION_OUTDATED | Sí | Demaneu instal·lar, activar o actualitzar Play Services |
| -5 | CANNOT_BIND_TO_SERVICE | Sí | Retard exponencial i, després, actualitzar la Play Store |
| -8 | CLIENT_TRANSIENT_ERROR | Sí | Reintents limitats i, després, provar-ho més tard |
| -9 | APP_NOT_OWNED | No | No instal·lada per Google Play: instal·lació directa o una altra botiga |
| -10 | SDK_VERSION_OUTDATED | No | Publiqueu una biblioteca més recent |
| -11 | DEVICE_NOT_SUPPORTED | No | Tipus de dispositiu no compatible; nou a la versió 0.0.6[4] |
| -100 | INTERNAL_ERROR | No | El text de Google encara suggereix reintents limitats; el codi anterior no ho reintenta |
Referència dels codis d'error de Google.[7] Un error no és una edat: recorreu a l'experiència predeterminada.
Migrar des de 0.0.3 i 0.0.4
La versió 0.0.3 encara retorna respostes però no rep actualitzacions.[12] Migrar des d'aquesta implica reescriure la ruta de lectura; des de la 0.0.4 el canvi és petit.
| Al vostre codi | A la versió 0.0.6 | Des de |
|---|---|---|
Només checkAgeSignals | requestAgeSignalsAccess abans[4] | 0.0.3 |
userStatus() | Eliminat: ageRangeSource() i significantChangeStatus()[4] | 0.0.3 |
VERIFIED | TIER_C o TIER_D (segons la nostra interpretació) | 0.0.3 |
DECLARED | TIER_A, o TIER_B si el gestiona un progenitor (la nostra interpretació) | 0.0.3 |
SUPERVISED | TIER_B (la nostra interpretació) | 0.0.3 |
SUPERVISED_APPROVAL_PENDING, SUPERVISED_APPROVAL_DENIED | TIER_B amb PENDING o DECLINED (la nostra interpretació) | 0.0.3 |
UNKNOWN, null | L'estat d'accés: VERIFICATION_REQUIRED o NOT_SHARED (la nostra interpretació) | 0.0.3 |
mostRecentApprovalDate() | significantChangeApprovalDate()[4] | 0.0.3 |
| Dues crides, nivells | Sense canvis; afegiu getApplicableAgeFeatures si és útil[4] | 0.0.4 |
| Gestió d'errors | Afegiu DEVICE_NOT_SUPPORTED[4] | Tots dos |
minSdk 23 | La biblioteca declara 24[11] | Tots dos |
Google no publica cap correspondència valor per valor. Les files marcades com «la nostra interpretació» provenen de comparar ambdues definicions.[3][12]
Atenció
Les antigues constants d'AgeSignalsVerificationStatus encara s'inclouen a la versió 0.0.6, de manera que les importacions compilen mentre userStatus() no existeix.[11] A la versió 0.0.3, VERIFIED era 0; a la 0.0.6, 0 és UNSPECIFIED.[10][11] Esborreu els enters emmagatzemats a la memòria cau en actualitzar.
Feu proves amb FakeAgeSignalsManager i provadors de llicències
FakeAgeSignalsManager no es comunica mai amb la Play Store; la seva referència el limita a proves unitàries i desenvolupament inicial.[32] Injecteu el gestor per poder substituir-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)
)
- Cobriu cada estat, una franja de menors, una franja d'adults, límits nuls i un error per crida (
setNextRequestAgeSignalsAccessExceptionisetNextApplicableAgeFeaturesExceptionfan fallar les altres dues). - Executeu la crida en real amb un provador de llicències: normalment una aplicació no actualitzada per Play rep
APP_NOT_OWNED; els provadors poden carregar directament una compilació de depuració.[6] - Mantingueu el nom del paquet idèntic al de l'aplicació de Play i inicieu sessió amb el compte de provador.[6]
Flutter, React Native, Expo i Unity
Són paquets de la comunitat o del marc de treball, no de Google, i incloure'ls no constitueix cap recomanació. Comproveu la versió de la biblioteca abans de publicar.
| Pila tecnològica | Paquet comprovat | Biblioteca | Aspectes clau abans de publicar |
|---|---|---|---|
| Expo | expo-age-range 58.0.3 | 0.0.4 | A la web i a iOS abans de la versió 26 retorna lowerBound: 18, com un adult[17] |
| React Native | react-native-play-age-range-declaration 3.0.5 | 0.0.4 | També integra altres botigues i Apple[19] |
| Flutter | age_range_signals 0.10.1 | 0.0.4 | Flux de dues crides, compatibilitat amb provadors de llicències[18] |
| Unity | unity-play-age-signals | 0.0.4 | GPL-3.0; les crides de retorn poden executar-se fora del fil principal[20] |
Consultat el 22 de novembre de 2026 a la pàgina o al fitxer de compilació de cada paquet.[17][18][19][20] L'equip d'Unity va indicar el desembre de 2025 que Unity no publicaria cap connector dedicat.[21]
Un paquet a la versió 0.0.4 no té getApplicableAgeFeatures ni DEVICE_NOT_SUPPORTED. Si els necessiteu, escriviu un petit pont natiu. La part d'Apple es compara a Play Age Signals vs Apple Declared Age Range.
No registreu, no compartiu ni creeu perfils
Les condicions de Google limiten la informació a experiències adequades a l'edat de conformitat amb la legislació, dins de l'aplicació sol·licitant.[5] La política prohibeix la publicitat, l'analítica, l'elaboració de perfils i la venda, compartició o transferència de dades a tercers, llevat que la llei ho exigeixi estrictament.[13]
- Mantingueu les franges, els nivells i l'
installIdfora dels registres, informes d'error i esdeveniments d'analítica: aquestes eines solen pertànyer a tercers. - Mantingueu el resultat en brut a la memòria sempre que sigui possible i deseu la decisió sobre la funcionalitat en comptes del nivell.
- No associeu mai el senyal amb cap proveïdor de comprovació d'edat, Didit inclòs.
- A Califòrnia, no demaneu als usuaris que canviïn la seva informació d'edat i no compartiu cap senyal amb tercers per a finalitats que el títol no requereixi.[15]
- Consulteu l'assessor jurídic abans de sol·licitar un senyal per a cada usuari: la llei de Califòrnia prohibeix les sol·licituds que ni aquesta ni cap altra llei aplicable exigeixin.[15]
Així, el missatge «visiteu la Play Store» correspon a VERIFICATION_REQUIRED, no a un usuari de Califòrnia la franja del qual poseu en dubte. La pàgina regional de Google indica que Califòrnia i el Brasil figuren com a obligatoris a partir de gener de 2027 i Alabama com a «detalls properament».[16] Les obligacions de Califòrnia es troben a la guia de la Digital Age Assurance Act.
Després del senyal: inicieu la vostra pròpia comprovació
La vostra aplicació decideix que cal una comprovació; la sol·licitud inclou un flux de treball i el vostre identificador d'usuari, mai la resposta de Google. Crideu Didit des del vostre servidor, ja que la clau d'API no ha d'arribar mai al dispositiu.
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"
}'
La resposta 201 conté session_id, session_token i url.[25] Envieu només el token a l'aplicació i, a continuació, inicieu l'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()
}
}
El resultat de l'SDK és per a la interfície. Preneu la decisió a partir del webhook signat status.updated o llegiu GET /v3/session/{sessionId}/decision/ des del vostre servidor.[25][29] Mantingueu l'opció predeterminada segura en cas de cancel·lació o fallada.
Coneixeu els límits
Si el senyal és suficient, ometeu aquest pas. Una comprovació pròpia no sempre és millor. Les lleis d'Alabama i Utah, amb obligacions a partir de 2027, apliquen la categoria d'edat més baixa per a les proteccions que cobreixen, i el Brasil l'alternativa més protectora, de manera que en aquests territoris una comprovació només pot restringir més.[22][23][24] Les persones cobertes per les lleis d'Illinois, Texas o Colorado necessiten el pas de consentiment biomètric abans de fer-se una selfie, que l'SDK natiu 4.10.0 o posterior pot mostrar.[28] Confirmeu amb l'assessor jurídic quina norma s'aplica a la vostra aplicació.
Com ajuda Didit després del senyal
Didit Age Estimation estima una edat a partir d'una selfie, amb prova de vida en el mateix pas, i no diu qui és la persona. Un flux de treball pot enviar una franja límit que configureu a una comprovació documental.[27] Age Estimation costa $0.10 per crida; consulteu els preus.

El resultat de l'estimació d'edat a la consola de Didit (dades de mostra): l'estimació a partir de la selfie al costat de l'edat al document.
Hi ha SDK natius per a Android, iOS, React Native i Flutter. Per a Unity i altres motors, la via documentada és la integració mitjançant WebView.[31] Els entorns fora de Google Play es cobreixen a API de verificació d'edat: aplicacions, web i botigues i a la pàgina de la solució de verificació d'edat.
Didit proporciona
- Una comprovació d'edat allotjada amb selfie, prova de vida i un pas documental opcional
- Una opció de flux de treball ISO/IEC 27566-1 que retorna una decisió de sí o no sobre l'edat i cap dada personal, a partir d'una edat mínima de 13 anys[27]
- Finestres de retenció, selectors de dades retornades i una crida d'eliminació[30]
Queda al vostre càrrec
- La crida a Play Age Signals i el seu resultat
- Quina llei s'aplica i si cal fer cap comprovació
- El valor predeterminat adequat per a l'edat i la decisió final d'accés
Didit no té cap connector per a Play Age Signals: el senyal es queda a la vostra aplicació.
Vegeu com funciona la branca alternativa a la vostra aplicació
Porteu el vostre control d'edat, els vostres mercats i la vostra pila tecnològica, o creeu el flux de treball vosaltres mateixos.
Conclusions principals
- Feu servir la 0.0.6: crida de funcions opcionals, sol·licitud d'accés i després
checkAgeSignalsnomés ambSHARED. - Condicioneu l'accés amb
ageLower; unageUppernul indica la franja superior, i les edats personalitzades el poden situar per sota de 18. - Límits nuls,
UNSPECIFIEDi errors equivalen a absència de senyal, mai a un adult. - El manifest de la 0.0.6 declara minSdk 24.
- Mantingueu el senyal a la vostra aplicació i inicieu qualsevol comprovació pròpia sense ell.
Preguntes freqüents
Quina versió de la Play Age Signals API he de fer servir?
Feu servir la 0.0.6. És la versió actual, disponible globalment, i Google diu que retornarà respostes per a tots els usuaris com a molt tard l'11 de desembre de 2026; mentrestant, la 0.0.4 continua retornant respostes en regions seleccionades.[2]
He de cridar getApplicableAgeFeatures?
No, Google la marca com a opcional. Crideu-la quan les vostres pròpies pantalles hagin de ser diferents per a un usuari per a qui compartir sigui obligatori.[2]
Quina diferència hi ha entre NOT_SHARED i VERIFICATION_REQUIRED?
NOT_SHARED significa que la vostra aplicació no rep cap senyal d'edat perquè l'usuari o el progenitor no ha acceptat compartir. VERIFICATION_REQUIRED significa que l'edat no està verificada en una regió on tant la verificació com la compartició són obligatòries, i Google us indica que demaneu a l'usuari que visiti la Play Store.[2]
Per què tots dos límits són nuls?
La referència de resposta proporciona límits nuls quan l'estat és NOT_SHARED o VERIFICATION_REQUIRED.[3] Tracteu els límits nuls com a absència de senyal, i mai com un adult.
Per què ageUpper és null per als adults?
Perquè la franja superior és oberta: 18+ retorna ageLower 18 i ageUpper null.[3] Amb edats personalitzades, la franja superior pot començar més avall, de manera que heu de comparar ageLower amb la vostra pròpia edat mínima.
Puc definir els meus propis intervals d'edat?
Sí, fins a tres edats mínimes a la pàgina Age signals de Play Console, amb una diferència d'almenys dos anys entre elles i modificables un cop l'any. Aquestes substitueixen els intervals predeterminats.[3]
Com puc fer proves abans que la llei s'apliqui?
Utilitzeu FakeAgeSignalsManager per retornar qualsevol estat, interval o error, incloent-hi MANDATORY_SHARING. Un compte de provador de llicència permet que una compilació de depuració instal·lada de manera externa cridi l'API en directe.[6]
Funciona en una Trusted Web Activity o en un WebView?
No des del codi web. És una biblioteca d'Android cridada amb una Activity, i les pàgines de Google que hem consultat no documenten cap interfície web. Una aplicació contenidora necessitaria el seu propi codi natiu, i les condicions de Google limiten la informació a l'aplicació sol·licitant.[2][5]
Hi ha algun complement per a Unity, Flutter o React Native?
Hi ha paquets de la comunitat i del marc de treball. Els que vam revisar el 22 de novembre de 2026 declaren la versió 0.0.4, de manera que no inclouen getApplicableAgeFeatures. El personal d'Unity va indicar el desembre de 2025 que Unity no publicaria cap complement dedicat.[17][18][19][20][21]
Puc emmagatzemar el resultat al meu servidor?
Les pàgines de Google descriuen expressament l'emmagatzematge d'installId al vostre servidor per a notificacions de revocació. Pel que fa a la resta, conserveu el resultat mínim que requereixi la vostra obligació legal, dins dels vostres propis sistemes, i mai en eines d'analítica, publicitat o serveis de tercers llevat que la llei ho exigeixi estrictament.[9][13]
Fonts
- Utilitzar la Play Age Signals API (beta), Android Developers, actualitzat el 19 de novembre de 2026.
- Sol·licitar senyals d'edat, Android Developers, actualitzat el 18 de novembre de 2026.
- Comprendre les respostes dels senyals d'edat, Android Developers, actualitzat el 18 de novembre de 2026.
- Notes de la versió de Play Age Signals, Android Developers, actualitzat el 19 de novembre de 2026.
- Visió general i condicions del servei de Play Age Signals, Android Developers, actualitzat el 18 de novembre de 2026.
- Provar la integració de la Play Age Signals API (beta), Android Developers, actualitzat el 19 de novembre de 2026.
- Referència dels codis d'error de la Play Age Signals API, Android Developers, actualitzat el 18 de novembre de 2026.
- Notificar canvis significatius a Google Play, Android Developers, actualitzat el 4 de setembre de 2026.
- Revisar les aprovacions revocades d'aplicacions, Android Developers, actualitzat el 4 de setembre de 2026.
- Referència d'AgeRangeSource, Android Developers, actualitzat el 18 de novembre de 2026.
- com.google.android.play:age-signals, Google Maven; manifestos i classes de la biblioteca de les versions 0.0.3, 0.0.4 i 0.0.6 consultats el 22 de novembre de 2026.
- Utilitzar la Play Age Signals API, versió 0.0.3, Android Developers, actualitzat el 23 d'octubre de 2026.
- Política sobre l'Age Signals API i les dades d'usuari, Google Play Console Help.
- Informació sobre com compartir intervals d'edat a Google Play, Google Play Help.
- AB 1856, Chapter 184, Statutes of 2026, California Legislative Information; modifica el Civil Code 1798.500 a 1798.504.
- Proteccions regionals relacionades amb l'edat a Play, Android Developers, actualitzat el 18 de novembre de 2026.
- Expo AgeRange, documentació d'Expo; paquet expo-age-range 58.0.3.
- age_range_signals, pub.dev, versió 0.10.1 de 6 d'octubre de 2026.
- react-native-play-age-range-declaration, GitHub, versió 3.0.5.
- unity-play-age-signals, GitHub, actualitzat el 4 d'agost de 2026.
- Play Age Signals API Support, Unity Discussions, resposta de l'equip d'Unity de desembre de 2025.
- Code of Alabama 8-19K-9 (HB 161), Alabama Legislature.
- Utah Code 13-76-202, Utah Legislature; obligacions dels desenvolupadors a partir del 6 de maig de 2027.
- Decreto 12.880 de 18 de març de 2026, art. 25, Planalto, Brasil.
- Crear sessió, documentació de Didit.
- SDK d'Android, documentació de Didit.
- Visió general de l'estimació d'edat, documentació de Didit.
- Consentiment biomètric, documentació de Didit.
- Webhooks, documentació de Didit.
- Retenció de dades, documentació de Didit.
- Visió general dels SDK natius, documentació de Didit.
- Referència de FakeAgeSignalsManager, Android Developers, actualitzat el 18 de novembre de 2026.
Implementeu les tres crides, proveu cada fila de la taula i mantingueu el senyal on el deixen les condicions de Google: a la vostra aplicació. Per a les branques que no pugui respondre, afegiu l'estimació d'edat com a comprovació pròpia.
Afegiu la comprovació per als usuaris sense senyal
Sol·liciteu una demo d'estimació d'edat a la vostra aplicació, o bé creeu un flux de treball i inicieu una sessió avui mateix.
Articles relacionats
- Google Play Age Signals API: què canvia el gener de 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