Mwongozo wa kuunganisha Play Age Signals API: v0.0.6 ya programu za Android
Miito mitatu ya Play Age Signals 0.0.6 katika Kotlin, jedwali la uamuzi kwa kila hali, kiwango na mpaka, makosa, uhamiaji kutoka 0.0.3 na 0.0.4, majaribio, na jinsi ya kuanza ukaguzi wako wa umri.

Kwa ufupi
Kuunganisha Play Age Signals API leo, ongeza com.google.android.play:age-signals:0.0.6, ita requestAgeSignalsAccess ukiwa na Activity, na uite checkAgeSignals pale tu ambapo hali ni SHARED.[1][2]
- Soma umri kutoka
ageLower. Daraja linaeleza jinsi umri ulivyobainishwa, na null kamwe haimaanishi mtu mzima. - Manifest ya maktaba ya 0.0.6 inabainisha minSdk 24, ingawa mwongozo unasema API 23.[1][11]
- Ishara inabaki kwenye programu yako. Ikiwa unahitaji ukaguzi wako mwenyewe wa umri, ianzishe bila ishara hiyo.
Huu ni mwongozo wa uhandisi wa Play Age Signals API: kwanza Android, kisha Flutter, React Native, Expo na Unity. Kuhusu nani anaathirika na kile kinachoanza mnamo Januari 2027, soma Google Play Age Signals API: nini kinabadilika mnamo Januari 2027. Google hutoa API na haikulazimishi kuiita; sheria inaweza kulazimisha.
Kila class, method na enum hapa chini vimekaguliwa dhidi ya kurasa za Google na maktaba iliyochapishwa ya 0.0.6 mnamo 22 Novemba 2026; Kotlin ya ishara hiyo inakusanywa kwa kutumia maktaba hiyo.
Unachohitaji
API inafanya kazi kwenye simu, vifaa vinavyokunjika na kompyuta kibao, kupitia programu ya Play Store kwenye kifaa.[1][5]
- Weka
minSdkkuwa 24 (tazama onyo). - Sambaza kupitia Google Play: masharti yanawekea kikomo API kwa programu ambazo Google Play inazisasisha.[5]
- Fungua ukurasa wa Age signals katika Play Console: umri maalum, mabadiliko makubwa na idhini zilizobatilishwa zinapatikana hapo.[3][8][9]
- Jaza fomu ya usalama wa data ya Play wewe mwenyewe. Google inasema maktaba ya mteja haikusanyi data yoyote na kwamba fomu hiyo ni uamuzi wako.[5]
Tahadhari
Ukurasa wa usanidi wa Google unasema Android 6.0, API level 23.[1] Manifest ndani ya maktaba ya 0.0.6 inabainisha minSdkVersion 24; 0.0.3 na 0.0.4 zilibainisha 23.[11] Programu iliyo na minSdk 23 inaweza kuacha kujenga wakati wa kuunganisha manifest baada ya sasisho. Kuipandisha hadi 24 ndio suluhisho rahisi.
- Februari 20260.0.3Wito mmoja,
userStatus, unaongeza DECLARED. - Julai 20260.0.4Wito miwili, madaraja yanachukua nafasi ya
userStatus. - Novemba 20260.0.6Inapatikana ulimwenguni kote; inaongeza
getApplicableAgeFeatures. - 11 Desemba 2026Watumiaji woteTarehe ya Google ya majibu kwa kila mtu.
Matoleo ya maktaba, kutoka kwa maelezo ya toleo na bango la Google.[2][4] Hadi tarehe hiyo, tarajia baadhi ya watumiaji kutopata jibu.
Ongeza maktaba
Tegemezi moja.[1] Meneja bandia kwa majaribio yumo katika artifact hiyo hiyo.[11]
dependencies {
implementation("com.google.android.play:age-signals:0.0.6")
}
1getApplicableAgeFeatures (ya hiari)
Iwapo kushiriki ni kwa lazima kwa mtumiaji huyu.
2requestAgeSignalsAccess
Inaweza kuonyesha kidokezo cha Google Play chenyewe.
Hali ni SHARED
3checkAgeSignals
Soma mipaka, chanzo, hali ya mabadiliko.
Hakuna umri kutoka kwa Google
Tumia mpangilio wako chaguo-msingi unaolingana na umri.
Mlolongo wa miito katika 0.0.6.[2]
Hatua ya 1: Je, kushiriki ni lazima kwa mtumiaji huyu?
Mwito huu ni wa hiari.[2] features() ina MANDATORY_SHARING tu kwa watumiaji katika maeneo ambayo sheria za maeneo hayo zinahitaji maduka ya programu kushiriki taarifa za umri, na ni tupu kwa kila mtu mwingine.[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) }
Kumbuka
Ya lazima inamaanisha kuwa ushiriki wa mtumiaji ni wa lazima. Haisemi chochote kuhusu jinsi umri ulivyobainishwa: Google inaeleza MANDATORY_SHARING pamoja na TIER_A, TIER_B, TIER_C na TIER_D.[3]
Hatua ya 2: omba ufikiaji
Maandishi ya Google yanaandika requestAgeSignalsAccess(Activity); mbinu hiyo huchukua AgeSignalsAccessRequest inayobeba Activity.[2] Iite pale ambapo kidokezo kinakubalika.
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) }
Kile anachokiona mtumiaji hutegemea eneo na mpangilio:[2]
| Mtumiaji | Kidokezo | Hali |
|---|---|---|
| Jimbo la Marekani ambapo maduka lazima yatoe umri uliothibitishwa kwa watumiaji waliothibitishwa au wanaosimamiwa | Hakuna | SHARED |
| Hali hiyo hiyo, bado haijathibitishwa | Hakuna katika programu yako; Play huishughulikia | VERIFICATION_REQUIRED |
| Kwingineko, Uliza kabla ya kushiriki (chaguo-msingi[14]) | Kidokezo cha Play ndani ya programu | SHARED au NOT_SHARED |
| Kwingineko, Shiriki kila wakati | Hakuna | SHARED |
| Kwingineko, Usishiriki kamwe | Hakuna | NOT_SHARED |
| Kwingineko, mtumiaji anayesimamiwa | Hakuna; mzazi huamua katika Family Link | SHARED au NOT_SHARED |
Baada ya kidokezo kufungwa mara chache Play huacha kuonyesha kidokezo, kwa hivyo usiite kwa mzunguko.[2] Mahali ambapo kushiriki ni lazima mpangilio umewekwa kuwa Shiriki kila wakati.[14]
Oanisha kizuizi chako cha umri na ishara
Tuonyeshe kizuizi chako na masoko yako, nasi tutakuonyesha ni matawi gani yanayohitaji ukaguzi wako mwenyewe na yapi hayahitaji.
Hatua ya 3: soma matokeo
Kila sehemu inaweza kuwa tupu (nullable), kwa hivyo ibadilishe mara moja na utumie aina moja katika programu yako. Oanishaji huu unasoma umri kutoka kwa mipaka pekee.
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) }
}
Konstanti za hali, chanzo na mabadiliko ni nambari kamili ambapo 0 ni UNSPECIFIED.[10][11] Shughulikia hilo katika tawi la else. Mwongozo wa Google wa 0.0.3 ulishauri ombi jipya wakati programu inafunguliwa kwa sababu thamani hubadilika[12]; mtumiaji anaweza pia kuzima ushiriki baadaye.[14]
Kumbuka
Mwongozo huo pia unapendekeza kuita Play Integrity API sambamba, ili ombi litoke kwenye toleo lisilobadilishwa kwenye kifaa kilichoidhinishwa.[12] Ishara hiyo ni jibu la upande wa mteja: usiamini kundi la umri ambalo mteja aliyebadilishwa anatuma kwa seva yako.
Jedwali la maamuzi: hali x chanzo x mipaka
Masafa chaguo-msingi ni 0-12, 13-15, 16-17 na 18+.[3] Safu wima ya mwisho ni ushauri wetu wa uhandisi, si wa Google.
| Hali | Chanzo | Ya chini / ya juu | Inamaanisha nini | Msimbo wako hufanya nini |
|---|---|---|---|---|
| Hitilafu | hakuna | hakuna | Hakuna jibu[7] | Jaribu tena ikiwa kosa linaweza kujaribiwa tena, kisha usichukue ishara |
NOT_SHARED | null | null / null | Mtumiaji au mzazi hakukubali kushiriki[2][3] | Chaguo-msingi linalolingana na umri, hakuna kidokezo cha kurudia |
VERIFICATION_REQUIRED | null | null / null | Haijathibitishwa, katika eneo ambalo uthibitishaji na ushiriki ni lazima[2][3] | Elekeza kwenye Play Store, hifadhi chaguo-msingi |
SHARED | TIER_A | 13 / 15 | Mtumiaji alitoa umri kwa Google, ambayo huenda imethibitisha au la[3] | Tumia kundi la umri |
SHARED | TIER_A | 18 / null | Sawa, kundi la watu wazima[3] | Itumie; ongeza ukaguzi pale tu sheria au hatari inapohitaji zaidi |
SHARED | TIER_B | 13 / 15 | Umri unaosimamiwa na mzazi au mlezi[3] | Tumia kundi la umri, soma hali ya mabadiliko |
SHARED | TIER_C | 18 / null | Imetathminiwa kwa kadi ya mkopo, barua pepe, selfie, kitambulisho cha serikali au kitambulisho cha kodi[3] | Tumia kundi la umri |
SHARED | TIER_D | 18 / null | Kitambulisho cha serikali pamoja na selfie, au kitambulisho cha dijitali[3] | Tumia kundi la umri |
SHARED | yoyote | null / yoyote | Haipo kwenye jedwali la majibu la Google | Chukulia kama hakuna ishara |
Tafsiri tatu husababisha makosa mengi:
- TIER_A si "haijathibitishwa". Mtu mzima aliyethibitisha kwa kitambulisho cha dijitali lakini anayeshiriki kwa hiari pia huja kama TIER_A.[3] TIER_C na TIER_D hurejeshwa tu katika maeneo ambapo uthibitishaji wa umri ni wa lazima, kwa mfano Texas.[3] Marejeleo ya class huweka TIER_A kama "iliyojitangaza"; mwongozo wa majibu ni makini zaidi.[3][10]
- TIER_B si umri. Inaeleza ni nani anayeisimamia. Soma mipaka.
- Mipaka ya null si mtu mzima aliyethibitishwa. Maoni katika sampuli ya Java ya Google yanapendekeza hivyo; sampuli yake ya Kotlin inasema mtumiaji hashiriki, na jedwali la majibu linakubaliana na Kotlin.[2][3]
Wakati wa kuacha hapa
Ikiwa kundi la umri linajibu swali lako na hakuna sheria au hatari inayodai zaidi, acha. Ukaguzi wa pili kwa kila mtumiaji ni mgumu kuoanisha na upunguzaji wa data, na huko California ishara ndiyo kiashiria kikuu isipokuwa uwe na taarifa za ndani zilizo wazi na za kusadikisha.[15]
Ambapo tawi linaishia bila ishara yoyote, muundo wa kinachofuata upo kwenye nini cha kufanya kuhusu NOT_SHARED, TIER_A au bila jibu.
Unahitaji jibu pale ambapo ishara haina jibu
Pata onyesho la makadirio ya umri katika programu yako: selfie kwanza, hati kwa kesi zinazotia shaka pekee.
Umri wa chini maalum
Kwenye kichupo cha Custom age ranges unaweka hadi viwango vitatu vya umri wa chini, vinavyotofautiana kwa angalau miaka miwili, vinavyoweza kubadilishwa mara moja kwa mwaka. Vinabatilisha jibu chaguo-msingi.[3]
| Viwango vya umri wa chini vilivyowekwa | Masafa yaliyorejeshwa | Kundi la juu |
|---|---|---|
| Hakuna (chaguo-msingi) | 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 |
Mifano kutoka kwa mwongozo wa majibu wa Google.[3]
Mfano
Unaweka 13 na 17. Kwa mtu wa miaka 25, API sasa inarejesha 17 / null, sawa na mtu wa miaka 17. Msimbo unaosoma ageUpper kuwa null kama mtu mzima unaruhusu watu wa miaka 17 kuingia kwenye kipengele cha 18+, kwa hivyo weka 18 kwenye orodha yako ikiwa unazuia kwa 18. Mipaka iliyoandikwa kwenye nyaraka inaishia 18[3]: API hii haiwezi kujibu kizuizi cha 21.
Mabadiliko makubwa na idhini zilizobatilishwa
Vipengele vyote viwili ni kwa ajili ya watumiaji wanaosimamiwa. Sheria gani inayofanya mabadiliko kuwa makubwa ni uamuzi wako, si wa Play[8]; kanuni za majimbo ziko katika App Store Accountability Acts.
Unaiarifu Play
Mabadiliko makubwa
- Hadi mabadiliko 3, hadi siku 90 mbele, yakiwa yametenganishwa kwa zaidi ya siku 2
- Maelezo ya Kiingereza yanahitajika, yanaonyeshwa neno kwa neno kwa wazazi
significantChangeStatusni APPROVED, PENDING au DECLINED- Programu yako lazima iwekee vikwazo kipengele kilichobadilishwa
Inajumlisha: idhini moja inashughulikia mabadiliko yote yanayosubiri[8]
Play inakuarifu
Idhini iliyobatilishwa
installIdni ya kila mtumiaji na kifaa, na haidumu baada ya kuweka upya mipangilio- Unaweza kuihifadhi kwenye seva yako ya nyuma kwa madhumuni haya pekee
- Vitambulisho vilivyobatilishwa huonekana kama CSV katika Play Console
- Kila ingizo hufutwa baada ya siku 90, kwa hivyo pakua kulingana na ratiba
Kitambulisho kimoja kinaweza kuonekana zaidi ya mara moja[9]
Weka kizuizi kwenye kipengele kilichobadilishwa, si programu nzima, kukiwa na PENDING na DECLINED. Hali ni null kwa akaunti zisizosimamiwa na kwa zile zinazosimamiwa zisizo na mabadiliko yaliyorekodiwa.[3]
Hitilafu na vifaa visivyoungwa mkono
Hitilafu hufika kama AgeSignalsException. Google inashauri kujaribu tena kukiwa na idadi ya juu zaidi ya majaribio.[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)
}
| Msimbo | Konstanti | Jaribu tena | Hatua |
|---|---|---|---|
| -1, -6 | API_NOT_AVAILABLE, PLAY_STORE_VERSION_OUTDATED | Ndiyo | Omba kusasisha Play Store |
| -2 | PLAY_STORE_NOT_FOUND | Ndiyo | Omba kusakinisha au kuwezesha Play Store |
| -3 | NETWORK_ERROR | Ndiyo | Omba kuangalia muunganisho |
| -4, -7 | PLAY_SERVICES_NOT_FOUND, PLAY_SERVICES_VERSION_OUTDATED | Ndiyo | Omba kusakinisha, kuwezesha au kusasisha Play Services |
| -5 | CANNOT_BIND_TO_SERVICE | Ndiyo | Rudi nyuma kwa muda unaoongezeka (exponential backoff), kisha sasisha Play Store |
| -8 | CLIENT_TRANSIENT_ERROR | Ndiyo | Jaribu tena kwa ukomo, kisha jaribu baadaye |
| -9 | APP_NOT_OWNED | Hapana | Haijasakinishwa na Google Play: kupakia kando au duka lingine |
| -10 | SDK_VERSION_OUTDATED | Hapana | Toa maktaba mpya zaidi |
| -11 | DEVICE_NOT_SUPPORTED | Hapana | Aina ya kifaa haihudumiwi; mpya katika 0.0.6[4] |
| -100 | INTERNAL_ERROR | Hapana | Maandishi ya Google bado yanapendekeza majaribio yenye ukomo; msimbo ulio hapo juu haujaribu tena |
Rejeleo la misimbo ya hitilafu ya Google.[7] Hitilafu si umri: rudi kwenye uzoefu chaguo-msingi.
Hamia kutoka 0.0.3 na 0.0.4
Toleo la 0.0.3 bado linarudisha majibu lakini halipati masasisho yoyote.[12] Kuhama kutoka toleo hilo kunahitaji kuandika upya njia ya kusoma; kutoka 0.0.4 mabadiliko ni madogo.
| Katika msimbo wako | Katika 0.0.6 | Kutoka |
|---|---|---|
checkAgeSignals pekee | requestAgeSignalsAccess kwanza[4] | 0.0.3 |
userStatus() | Zimeondolewa: ageRangeSource() na significantChangeStatus()[4] | 0.0.3 |
VERIFIED | TIER_C au TIER_D (ufafanuzi wetu) | 0.0.3 |
DECLARED | TIER_A, au TIER_B ikiwa mzazi anaisimamia (ufafanuzi wetu) | 0.0.3 |
SUPERVISED | TIER_B (ufafanuzi wetu) | 0.0.3 |
SUPERVISED_APPROVAL_PENDING, SUPERVISED_APPROVAL_DENIED | TIER_B ikiwa na PENDING au DECLINED (ufafanuzi wetu) | 0.0.3 |
UNKNOWN, null | Hali ya ufikiaji: VERIFICATION_REQUIRED au NOT_SHARED (ufafanuzi wetu) | 0.0.3 |
mostRecentApprovalDate() | significantChangeApprovalDate()[4] | 0.0.3 |
| Miito miwili, madaraja | Haijabadilika; ongeza getApplicableAgeFeatures ikiwa ni muhimu[4] | 0.0.4 |
| Ushughulikiaji wa hitilafu | Ongeza DEVICE_NOT_SUPPORTED[4] | Zote mbili |
minSdk 23 | Maktaba inabainisha 24[11] | Zote mbili |
Google haichapishi ulinganishaji wa thamani kwa thamani. Safu mlalo zilizotiwa alama ya "ufafanuzi wetu" zinatokana na kulinganisha fasili zote mbili.[3][12]
Tahadhari
Konstanti za zamani za AgeSignalsVerificationStatus bado zinajumuishwa ndani ya 0.0.6, kwa hivyo uagizaji unakusanyika wakati userStatus() haipo.[11] Katika 0.0.3, VERIFIED ilikuwa 0; katika 0.0.6, 0 ni UNSPECIFIED.[10][11] Futa nambari kamili zilizohifadhiwa kwenye kache unaposasisha.
Fanya majaribio ukitumia FakeAgeSignalsManager na wajaribio wa leseni
FakeAgeSignalsManager haiwasiliani kamwe na Play Store; marejeleo yake yanaizuia kwenye majaribio ya kizio na uundaji wa awali pekee.[32] Ingiza meneja ili uweze kuibadilisha.
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)
)
- Jumuisha kila hali, kundi la umri wa watoto, kundi la umri wa watu wazima, mipaka ya null na hitilafu moja kwa kila wito (
setNextRequestAgeSignalsAccessExceptionnasetNextApplicableAgeFeaturesExceptionhushindisha zile nyingine mbili). - Tekeleza wito halisi ukitumia mjaribio wa leseni: kwa kawaida programu ambayo haijasasishwa na Play hupokea
APP_NOT_OWNED; wajaribio wanaweza kupakia kando toleo la utatuzi.[6] - Weka jina la kifurushi likiwa sawa kabisa na programu ya Play na uingie ukitumia akaunti ya mjaribio.[6]
Flutter, React Native, Expo na Unity
Hivi ni vifurushi vya jumuiya au fremu, si vya Google, na kuorodhesha kifurushi si pendekezo. Kagua toleo la maktaba kabla ya kusambaza programu yako.
| Mfumo wa teknolojia | Kifurushi kimekaguliwa | Maktaba | Fahamu kabla ya kusambaza |
|---|---|---|---|
| Expo | expo-age-range 58.0.3 | 0.0.4 | Kwenye wavuti na kwenye iOS kabla ya 26 inarudisha lowerBound: 18, kama mtu mzima[17] |
| React Native | react-native-play-age-range-declaration 3.0.5 | 0.0.4 | Pia hufunika maduka mengine na Apple[19] |
| Flutter | age_range_signals 0.10.1 | 0.0.4 | Mtiririko wa miito miwili, usaidizi kwa wajaribio wa leseni[18] |
| Unity | unity-play-age-signals | 0.0.4 | GPL-3.0; callback zinaweza kuendeshwa nje ya uzi mkuu[20] |
Ilisomwa mnamo 22 Novemba 2026 kutoka kwa kila ukurasa wa kifurushi au faili ya ujenzi.[17][18][19][20] Wafanyakazi wa Unity waliandika mnamo Desemba 2025 kwamba Unity haitatoa programu-jalizi maalum.[21]
Kifurushi kilicho kwenye 0.0.4 hakina getApplicableAgeFeatures na hakina DEVICE_NOT_SUPPORTED. Ikiwa unazihitaji, andika kiunganishi kidogo cha asili. Upande wa Apple unalinganishwa katika Play Age Signals dhidi ya Apple Declared Age Range.
Usiweke kwenye logi, usishiriki au kuweka wasifu
Masharti ya Google yanawekea kikomo taarifa hiyo kwa matumizi yanayolingana na umri kwa kuzingatia sheria, ndani ya programu inayoomba.[5] Sera inakataza utangazaji, uchanganuzi, uwekaji wasifu, na kuuza, kushiriki au kuhamisha data kwa wahusika wengine isipokuwa kama inavyotakiwa kabisa na sheria.[13]
- Weka vikundi vya umri, madaraja na
installIdnje ya logi, ripoti za hitilafu na matukio ya uchanganuzi: zana hizo kwa kawaida ni za wahusika wengine. - Weka matokeo ghafi kwenye kumbukumbu ya muda unapoweza, na uhifadhi uamuzi wa kipengele badala ya daraja.
- Usiambatanishe kamwe ishara hiyo kwa muuzaji wa uhakiki wa umri, Didit ikiwa ni pamoja na.
- Huko California, usiwashawishi watumiaji kubadilisha taarifa zao za umri, na usishiriki ishara yoyote na mtu wa tatu kwa madhumuni ambayo sheria haihitaji.[15]
- Uliza mshauri wa kisheria kabla ya kuomba ishara kwa kila mtumiaji: sheria ya California inakataza maombi ambayo hayahitajiki na sheria hiyo wala na sheria nyingine inayotumika.[15]
Kwa hivyo ujumbe wa "tembelea Play Store" ni wa VERIFICATION_REQUIRED, si wa mkazi wa California ambaye una shaka na kundi lake la umri. Ukurasa wa kikanda wa Google unaorodhesha California na Brazil kuwa lazima kuanzia Januari 2027 na Alabama kama "Maelezo yanakuja hivi karibuni".[16] Majukumu ya California yapo katika mwongozo wa Digital Age Assurance Act.
Baada ya ishara: anza ukaguzi wako mwenyewe
Programu yako inaamua kuwa ukaguzi unahitajika; ombi hubeba mtiririko wa kazi na kitambulisho chako cha mtumiaji, na kamwe halibebi jibu la Google. Ita Didit kutoka kwa seva yako, kwa sababu ufunguo wa API haupaswi kufikia kifaa.
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"
}'
Jibu la 201 linashikilia session_id, session_token na url.[25] Tuma tokeni pekee kwenye programu, kisha uanzishe 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()
}
}
Matokeo ya SDK ni ya kiolesura. Chukua uamuzi kutoka kwa webhook ya status.updated iliyosainiwa, au soma GET /v3/session/{sessionId}/decision/ kutoka kwa seva yako.[25][29] Weka chaguo-msingi salama wakati wa kughairi na kutofaulu.
Fahamu mipaka
Pale ambapo ishara inatosha, ruka hatua hii. Ukaguzi wako mwenyewe haushindi kila wakati. Sheria za Alabama na Utah, zenye majukumu kuanzia 2027, hutumia kategoria ya chini kabisa ya umri kwa ulinzi unaoshughulikiwa, na Brazil hutumia mbadala wenye ulinzi zaidi, kwa hivyo huko ukaguzi unaweza tu kuimarisha ulinzi.[22][23][24] Watu wanaoshughulikiwa na sheria ya Illinois, Texas au Colorado wanahitaji hatua ya idhini ya kibayometriki kabla ya picha ya selfie, ambayo SDK asili ya 4.10.0 au ya baadaye inaweza kuonyesha.[28] Thibitisha na mshauri wa kisheria ni sheria gani inatumika kwa programu yako.
Jinsi Didit inavyosaidia baada ya ishara
Didit Age Estimation inakadiria umri kutoka kwa selfie, ikiwa na uthibitisho wa uhai katika hatua hiyo hiyo, na haisemi mtu huyo ni nani. Mtiririko wa kazi unaweza kutuma kundi la umri la mpaka uliloweka kwenye ukaguzi wa hati.[27] Age Estimation inagharimu $0.10 kwa kila wito; tazama bei.

Matokeo ya ukadiriaji wa umri katika konsoli ya Didit (data ya mfano): ukadiriaji kutoka kwa selfie karibu na umri kwenye hati.
SDK asili zipo kwa Android, iOS, React Native na Flutter. Kwa Unity na injini nyingine njia iliyoandikwa kwenye nyaraka ni muunganisho wa WebView.[31] Maeneo ya nje ya Google Play yamefunikwa katika API ya uthibitishaji wa umri: programu, wavuti na maduka na kwenye ukurasa wa suluhisho la uhakiki wa umri.
Didit inatoa
- Ukaguzi wa umri unaohudumiwa wenye selfie, uthibitisho wa uhai na hatua ya hiari ya hati
- Chaguo la mtiririko wa kazi wa ISO/IEC 27566-1 linalorudisha uamuzi wa ndiyo au hapana kuhusu umri bila data binafsi, kuanzia umri wa chini wa miaka 13[27]
- Vipindi vya uhifadhi wa data, swichi za data inayorudishwa na wito wa kufuta[30]
Inabaki kwako
- Wito wa Play Age Signals na matokeo yake
- Ni sheria gani inatumika na ikiwa ukaguzi unahitajika kabisa
- Chaguo-msingi linalolingana na umri na uamuzi wa mwisho wa ufikiaji
Didit haina kiunganishi cha Play Age Signals: ishara inabaki ndani ya programu yako.
Tazama tawi la mbadala likifanya kazi kwenye programu yako
Leta kizuizi chako cha umri, masoko yako na teknolojia yako, au jenga mtiririko wa kazi wewe mwenyewe.
Mambo makuu ya kuzingatia
- Tumia 0.0.6: wito wa vipengele vya hiari, ombi la ufikiaji, kisha
checkAgeSignalstu kwenyeSHARED. - Weka kizuizi kwa
ageLower;ageUpperikiwa null inamaanisha kundi la juu, na umri maalum unaweza kuisogeza chini ya miaka 18. - Mipaka ya null,
UNSPECIFIEDna hitilafu ni kukosekana kwa ishara, kamwe si mtu mzima. - Manifest ya 0.0.6 inabainisha minSdk 24.
- Weka ishara ndani ya programu yako na uanze ukaguzi wako mwenyewe wowote bila ishara hiyo.
Maswali yanayoulizwa mara kwa mara
Ninapaswa kutumia toleo gani la Play Age Signals API?
Tumia 0.0.6. Ni toleo la sasa, linapatikana ulimwenguni kote, na Google inasema litarudisha majibu kwa watumiaji wote ifikapo 11 Desemba 2026; 0.0.4 inaendelea kurudisha majibu katika maeneo yaliyochaguliwa kwa sasa.[2]
Je, ninahitaji kuita getApplicableAgeFeatures?
Hapana, Google inaiweka kama ya hiari. Iite wakati skrini zako binafsi zinapaswa kutofautiana kwa mtumiaji ambaye ushiriki wake ni wa lazima.[2]
Kuna tofauti gani kati ya NOT_SHARED na VERIFICATION_REQUIRED?
NOT_SHARED inamaanisha programu yako haipati ishara ya umri kwa sababu mtumiaji au mzazi hakukubali kushiriki. VERIFICATION_REQUIRED inamaanisha umri haujathibitishwa katika eneo ambalo uthibitishaji na ushiriki ni wa lazima, na Google inakuelekeza kumwomba mtumiaji atembelee Play Store.[2]
Kwa nini mipaka yote miwili ni null?
Rejeleo la majibu hutoa mipaka ya null wakati hali ni NOT_SHARED au VERIFICATION_REQUIRED.[3] Chukulia mipaka ya null kama hakuna ishara, na kamwe si kama mtu mzima.
Kwa nini ageUpper ni null kwa watu wazima?
Kwa sababu kundi la juu halina kikomo: 18+ hurejesha ageLower 18 na ageUpper null.[3] Kwa umri maalum kundi la juu linaweza kuanzia chini zaidi, kwa hivyo linganisha ageLower na umri wako wa chini kabisa.
Je, ninaweza kuweka masafa yangu ya umri?
Ndiyo, hadi viwango vitatu vya umri wa chini kwenye ukurasa wa Age signals katika Play Console, vikiwa vimetenganishwa kwa angalau miaka miwili, vinavyoweza kubadilishwa mara moja kwa mwaka. Vinabatilisha masafa chaguo-msingi.[3]
Je, nifanyeje majaribio kabla ya sheria kuanza kutumika?
Tumia FakeAgeSignalsManager ili kurejesha hali, masafa au hitilafu yoyote, ikiwa ni pamoja na MANDATORY_SHARING. Akaunti ya mjaribio wa leseni inaruhusu toleo la utatuzi lililopakiwa kando kuita API ya moja kwa moja.[6]
Je, inafanya kazi katika Trusted Web Activity au WebView?
Si kutoka kwa msimbo wa wavuti. Ni maktaba ya Android inayoitwa kwa Activity, na kurasa za Google tulizosoma hazijaandika kiolesura chochote cha wavuti. Programu ya aina ya kifuniko ingehitaji msimbo wake asili, na masharti ya Google huweka kikomo cha taarifa kwa programu inayoomba pekee.[2][5]
Je, kuna programu-jalizi ya Unity, Flutter au React Native?
Kuna vifurushi vya jamii na fremu. Vile tulivyokagua mnamo 22 Novemba 2026 vinatangaza 0.0.4, kwa hivyo havina getApplicableAgeFeatures. Wafanyakazi wa Unity walisema mnamo Desemba 2025 kuwa Unity haitatoa programu-jalizi maalum.[17][18][19][20][21]
Je, ninaweza kuhifadhi matokeo kwenye seva yangu?
Kurasa za Google zinaeleza waziwazi kuhifadhi installId kwenye mfumo wako wa nyuma kwa arifa za kubatilisha. Kwa mengine yaliyosalia, weka matokeo madogo zaidi yanayohitajika na wajibu wako wa kisheria, ndani ya mifumo yako mwenyewe, na kamwe si katika uchanganuzi, matangazo au huduma ya wahusika wengine isipokuwa sheria inahitaji hivyo madhubuti.[9][13]
Vyanzo
- Use Play Age Signals API (beta), Android Developers, ilisasishwa 19 Novemba 2026.
- Request age signals, Android Developers, ilisasishwa 18 Novemba 2026.
- Understand age signals responses, Android Developers, ilisasishwa 18 Novemba 2026.
- Play Age Signals release notes, Android Developers, ilisasishwa 19 Novemba 2026.
- Play Age Signals overview and terms of service, Android Developers, ilisasishwa 18 Novemba 2026.
- Test your Play Age Signals API (beta) integration, Android Developers, ilisasishwa 19 Novemba 2026.
- Play Age Signals API error code reference, Android Developers, ilisasishwa 18 Novemba 2026.
- Notify Google Play of significant changes, Android Developers, ilisasishwa 4 Septemba 2026.
- Review revoked app approvals, Android Developers, ilisasishwa 4 Septemba 2026.
- AgeRangeSource reference, Android Developers, ilisasishwa 18 Novemba 2026.
- com.google.android.play:age-signals, Google Maven; manifest za maktaba na madarasa ya matoleo 0.0.3, 0.0.4 na 0.0.6 zilisomwa mnamo 22 Novemba 2026.
- Use Play Age Signals API, version 0.0.3, Android Developers, ilisasishwa 23 Oktoba 2026.
- Age Signals API and User Data policy, Google Play Console Help.
- About age range sharing on Google Play, Google Play Help.
- AB 1856, Chapter 184, Statutes of 2026, California Legislative Information; inarekebisha Civil Code 1798.500 hadi 1798.504.
- Regional age-related protections on Play, Android Developers, ilisasishwa 18 Novemba 2026.
- Expo AgeRange, nyaraka za Expo; kifurushi expo-age-range 58.0.3.
- age_range_signals, pub.dev, toleo 0.10.1 la 6 Oktoba 2026.
- react-native-play-age-range-declaration, GitHub, toleo 3.0.5.
- unity-play-age-signals, GitHub, iliyosasishwa 4 Agosti 2026.
- Play Age Signals API Support, Unity Discussions, jibu la wafanyakazi wa Unity la Desemba 2025.
- Code of Alabama 8-19K-9 (HB 161), Alabama Legislature.
- Utah Code 13-76-202, Utah Legislature; majukumu ya msanidi kuanzia 6 Mei 2027.
- Decreto 12.880 ya 18 Machi 2026, ibara ya 25, Planalto, Brazili.
- Unda kipindi, nyaraka za Didit.
- Android SDK, nyaraka za Didit.
- Muhtasari wa Age Estimation, nyaraka za Didit.
- Idhini ya kibayometriki, nyaraka za Didit.
- Webhooks, nyaraka za Didit.
- Uhifadhi wa data, nyaraka za Didit.
- Muhtasari wa Native SDKs, nyaraka za Didit.
- Marejeleo ya FakeAgeSignalsManager, Android Developers, iliyosasishwa 18 Novemba 2026.
Tekeleza miito hiyo mitatu, jaribu kila safu mlalo ya jedwali, na ubakize ishara pale masharti ya Google yanapoiacha: ndani ya programu yako. Kwa matawi ambayo haiwezi kuyajibu, ongeza makadirio ya umri kama ukaguzi wako mwenyewe.
Ongeza ukaguzi kwa watumiaji wasio na ishara
Pata onyesho la makadirio ya umri katika programu yako, au unda mtiririko wa kazi na uanzishe kipindi leo.
Makala zinazohusiana
- Play Age Signals dhidi ya Apple Declared Age Range: ulinganisho kamili
- Mwongozo wa kuunganisha Play Age Signals API: v0.0.6 ya programu za Android
- API ya uhakiki wa umri: inayofanya kazi kwenye programu, wavuti na maduka
- Uhakikishaji wa umri wa programu: michezo, mitandao, miadi, AI na zaidi
- Sheria za Uwajibikaji za App Store: Texas, Utah, Louisiana, Alabama
- Sheria ya uhakiki wa umri California 2027: sheria 4 kwa programu