Play Age Signals API इंटीग्रेशन गाइड: Android ऐप्स के लिए v0.0.6
Kotlin में Play Age Signals 0.0.6 के तीन कॉल्स, हर स्टेटस, टियर और बाउंड के लिए निर्णय तालिका, एरर्स, 0.0.3 और 0.0.4 से माइग्रेशन, टेस्टिंग और अपना एज चेक शुरू करने का तरीका।

संक्षेप में
Play Age Signals API को आज एकीकृत करने के लिए, com.google.android.play:age-signals:0.0.6 जोड़ें, किसी Activity के साथ requestAgeSignalsAccess को कॉल करें, और checkAgeSignals को केवल तभी कॉल करें जब स्टेटस SHARED हो।[1][2]
ageLowerसे आयु पढ़ें। टियर यह बताता है कि आयु कैसे स्थापित की गई थी, और null कभी भी वयस्क नहीं होता है।- 0.0.6 लाइब्रेरी मेनिफेस्ट minSdk 24 घोषित करता है, यद्यपि गाइड API 23 कहता है।[1][11]
- सिग्नल आपके ऐप में ही रहता है। यदि आपको अपने स्वयं के आयु सत्यापन की आवश्यकता है, तो इसे सिग्नल के बिना शुरू करें।
यह Play Age Signals API के लिए इंजीनियरिंग गाइड है: पहले Android, फिर Flutter, React Native, Expo और Unity। कौन प्रभावित है और जनवरी 2027 में क्या शुरू होता है, इसके लिए पढ़ें Google Play Age Signals API: जनवरी 2027 में क्या बदलता है। Google API की पेशकश करता है और आपको इसे कॉल करने के लिए बाध्य नहीं करता है; कोई कानून ऐसा कर सकता है।
नीचे दी गई प्रत्येक क्लास, मेथड और enum की जांच 22 नवंबर 2026 को Google के पेजों और प्रकाशित 0.0.6 लाइब्रेरी के आधार पर की गई थी; सिग्नल के लिए Kotlin इसके साथ कंपाइल होता है।
आपको क्या चाहिए
यह API डिवाइस पर Play Store ऐप के माध्यम से फ़ोन, फ़ोल्डेबल और टैबलेट पर चलता है।[1][5]
minSdkको 24 पर सेट करें (चेतावनी देखें)।- Google Play के माध्यम से शिप करें: शर्तें API को उन ऐप्स तक सीमित करती हैं जिन्हें Google Play अपडेट करता है।[5]
- Play Console में Age signals पेज खोलें: कस्टम आयु, महत्वपूर्ण परिवर्तन और निरस्त अनुमोदन वहीं होते हैं।[3][8][9]
- Play का डेटा सुरक्षा फ़ॉर्म स्वयं भरें। Google का कहना है कि क्लाइंट लाइब्रेरी कोई डेटा एकत्र नहीं करती है और फ़ॉर्म भरना आपका निर्णय है।[5]
ध्यान दें
Google का सेटअप पेज Android 6.0, API level 23 कहता है।[1] 0.0.6 लाइब्रेरी के अंदर का मेनिफेस्ट minSdkVersion 24 घोषित करता है; 0.0.3 और 0.0.4 ने 23 घोषित किया था।[11] minSdk 23 वाला ऐप अपग्रेड के बाद मेनिफेस्ट मर्ज पर बिल्ड होना बंद हो सकता है। इसे 24 तक बढ़ाना इसका सरल समाधान है।
- फ़रवरी 20260.0.3एक कॉल,
userStatus, DECLARED जोड़ता है। - जुलाई 20260.0.4दो कॉल, टियर्स
userStatusकी जगह लेते हैं। - नवंबर 20260.0.6ग्लोबल,
getApplicableAgeFeaturesजोड़ता है। - 11 दिसंबर 2026सभी यूज़र्ससभी उपयोगकर्ताओं को प्रतिक्रियाएं मिलने की Google की तारीख।
लाइब्रेरी के वर्ज़न, Google के रिलीज़ नोट्स और बैनर से।[2][4] उस तारीख तक, कुछ उपयोगकर्ताओं को कोई प्रतिक्रिया न मिलने की अपेक्षा करें।
लाइब्रेरी जोड़ें
एक डिपेंडेंसी।[1] टेस्ट के लिए फ़ेक मैनेजर उसी आर्टिफ़ैक्ट में है।[11]
dependencies {
implementation("com.google.android.play:age-signals:0.0.6")
}
1getApplicableAgeFeatures (वैकल्पिक)
क्या इस उपयोगकर्ता के लिए साझा करना अनिवार्य है।
2requestAgeSignalsAccess
Google Play का अपना प्रॉम्प्ट दिखा सकता है।
स्टेटस SHARED है
3checkAgeSignals
सीमाएं, स्रोत, परिवर्तन की स्थिति पढ़ें।
Google से कोई आयु प्राप्त नहीं हुई
अपने आयु-उपयुक्त डिफ़ॉल्ट का उपयोग करें।
0.0.6 में कॉल का क्रम।[2]
चरण 1: क्या इस उपयोगकर्ता के लिए साझा करना अनिवार्य है
यह कॉल वैकल्पिक है।[2] features() में केवल उन क्षेत्रों के उपयोगकर्ताओं के लिए MANDATORY_SHARING शामिल होता है जिनके कानून ऐप स्टोर के लिए आयु जानकारी साझा करना अनिवार्य बनाते हैं, और बाकी सभी के लिए यह खाली होता है।[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) }
नोट
अनिवार्य का अर्थ है कि उपयोगकर्ता की ओर से साझा करना अनिवार्य है। यह इस बारे में कुछ नहीं बताता कि आयु कैसे निर्धारित की गई थी: Google MANDATORY_SHARING को TIER_A, TIER_B, TIER_C और TIER_D के साथ प्रलेखित करता है।[3]
चरण 2: एक्सेस का अनुरोध करें
Google के टेक्स्ट में requestAgeSignalsAccess(Activity) लिखा है; यह मेथड एक AgeSignalsAccessRequest लेता है जिसमें Activity होती है।[2] इसे वहां कॉल करें जहां प्रॉम्प्ट स्वीकार्य हो।
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) }
उपयोगकर्ता क्या देखता है यह क्षेत्र और सेटिंग पर निर्भर करता है:[2]
| उपयोगकर्ता | प्रॉम्प्ट | स्थिति |
|---|---|---|
| US राज्य जहाँ स्टोरों को सत्यापित आयु देनी होती है; सत्यापित या पर्यवेक्षित | कोई नहीं | SHARED |
| वही, अभी तक सत्यापित नहीं | आपके ऐप में कोई नहीं; Play इसे संभालता है | VERIFICATION_REQUIRED |
| अन्यत्र, साझा करने से पहले पूछें (डिफ़ॉल्ट[14]) | Play का इन-ऐप प्रॉम्प्ट | SHARED या NOT_SHARED |
| अन्यत्र, हमेशा साझा करें | कोई नहीं | SHARED |
| अन्यत्र, कभी साझा न करें | कोई नहीं | NOT_SHARED |
| अन्यत्र, पर्यवेक्षित | कोई नहीं; अभिभावक Family Link में निर्णय लेते हैं | SHARED या NOT_SHARED |
कुछ बार खारिज किए जाने के बाद Play प्रॉम्प्ट दिखाना बंद कर देता है, इसलिए इसे लूप में कॉल न करें।[2] जहाँ साझा करना अनिवार्य है, वहाँ सेटिंग हमेशा साझा करें पर तय होती है।[14]
अपने आयु गेट को सिग्नल से मैप करें
हमें अपना आयु गेट और अपने बाज़ार दिखाएं, और हम आपको दिखाएंगे कि किन ब्रांचों को आपकी अपनी जांच चाहिए और किन्हें नहीं।
चरण 3: परिणाम पढ़ें
प्रत्येक फ़ील्ड nullable है, इसलिए एक बार रूपांतरित करें और अपने ऐप में एक प्रकार रखें। यह मैपिंग केवल सीमाओं से आयु पढ़ती है।
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) }
}
स्थिति, स्रोत और बदलाव कॉन्सटेंट पूर्णांक हैं जहाँ 0 UNSPECIFIED है।[10][11] इसे किसी else शाखा में संभालें। Google के 0.0.3 गाइड ने ऐप खुलने पर एक नए अनुरोध की सलाह दी क्योंकि मान बदलते हैं[12]; उपयोगकर्ता बाद में शेयरिंग बंद भी कर सकता है।[14]
नोट
वह गाइड साथ में Play Integrity API को कॉल करने की भी सिफारिश करता है, ताकि कॉल प्रमाणित डिवाइस पर मौजूद बिना छेड़छाड़ वाले बिल्ड से आए।[12] सिग्नल एक क्लाइंट-साइड उत्तर है: किसी संशोधित क्लाइंट द्वारा आपके सर्वर पर भेजे गए बैंड पर भरोसा न करें।
निर्णय तालिका: स्थिति x स्रोत x सीमाएं
डिफ़ॉल्ट श्रेणियां 0-12, 13-15, 16-17 और 18+ हैं।[3] अंतिम कॉलम हमारी इंजीनियरिंग सलाह है, Google की नहीं।
| स्थिति | स्रोत | निचली / ऊपरी | इसका क्या अर्थ है | आपका कोड क्या करता है |
|---|---|---|---|---|
| अपवाद | कोई नहीं | कोई नहीं | कोई उत्तर नहीं[7] | यदि दोबारा प्रयास संभव हो तो दोबारा प्रयास करें, फिर कोई सिग्नल नहीं |
NOT_SHARED | null | null / null | उपयोगकर्ता या अभिभावक साझा करने के लिए सहमत नहीं हुए[2][3] | आयु-उपयुक्त डिफ़ॉल्ट, कोई दोबारा प्रॉम्प्ट नहीं |
VERIFICATION_REQUIRED | null | null / null | सत्यापित नहीं, ऐसे क्षेत्र में जहाँ सत्यापन और साझा करना अनिवार्य है[2][3] | Play Store पर निर्देशित करें, डिफ़ॉल्ट बनाए रखें |
SHARED | TIER_A | 13 / 15 | उपयोगकर्ता ने Google को आयु दी, जिसे Google ने पुष्टि किया हो या न किया हो[3] | बैंड लागू करें |
SHARED | TIER_A | 18 / null | वही, वयस्क बैंड[3] | इसे लागू करें; अतिरिक्त जांच केवल तभी जोड़ें जब कानून या जोखिम अधिक की मांग करे |
SHARED | TIER_B | 13 / 15 | माता-पिता या अभिभावक द्वारा प्रबंधित आयु[3] | बैंड लागू करें, परिवर्तन की स्थिति पढ़ें |
SHARED | TIER_C | 18 / null | क्रेडिट कार्ड, ईमेल, सेल्फ़ी, सरकारी ID या टैक्स ID द्वारा मूल्यांकित[3] | बैंड लागू करें |
SHARED | TIER_D | 18 / null | सरकारी ID और सेल्फ़ी, या डिजिटल ID[3] | बैंड लागू करें |
SHARED | कोई भी | null / कोई भी | Google की रिस्पॉन्स टेबल में नहीं है | कोई सिग्नल न होने के रूप में मानें |
तीन व्याख्याएं अधिकांश गलतियों का कारण बनती हैं:
- TIER_A "unverified" नहीं है। एक वयस्क जिसने डिजिटल ID से सत्यापन किया है लेकिन अपनी पसंद से साझा करता है, वह भी TIER_A के रूप में आता है।[3] TIER_C और TIER_D केवल उन क्षेत्रों में लौटाए जाते हैं जहां आयु सत्यापन अनिवार्य है, उदाहरण के लिए Texas।[3] क्लास संदर्भ TIER_A को "self declared" लेबल करता है; रिस्पॉन्स गाइड अधिक सतर्क है।[3][10]
- TIER_B कोई आयु नहीं है। यह बताता है कि इसे कौन प्रबंधित करता है। सीमाएं पढ़ें।
- null सीमाएं कोई सत्यापित वयस्क नहीं हैं। Google के Java सैंपल में एक टिप्पणी इसका संकेत देती है; इसका Kotlin सैंपल कहता है कि उपयोगकर्ता साझा नहीं कर रहा है, और रिस्पॉन्स टेबल Kotlin से सहमत है।[2][3]
यहां कब रुकना है
यदि बैंड आपके प्रश्न का उत्तर देता है और कोई कानून या जोखिम अधिक की मांग नहीं करता है, तो रुकें। प्रत्येक उपयोगकर्ता पर दूसरी जांच डेटा न्यूनीकरण के साथ मेल नहीं खाती, और कैलिफ़ोर्निया में सिग्नल प्राथमिक संकेतक है जब तक कि आपके पास आंतरिक स्पष्ट और विश्वसनीय जानकारी न हो।[15]
जहां कोई ब्रांच बिना किसी सिग्नल के समाप्त होती है, उसके आगे की रूपरेखा NOT_SHARED, TIER_A या कोई उत्तर न मिलने पर क्या करें में दी गई है।
जहां सिग्नल का कोई उत्तर नहीं है, वहां उत्तर की आवश्यकता है
अपने ऐप में आयु अनुमान का डेमो प्राप्त करें: पहले सेल्फ़ी, दस्तावेज़ केवल सीमावर्ती मामलों के लिए।
कस्टम न्यूनतम आयु
Custom age ranges टैब पर आप अधिकतम तीन न्यूनतम आयु सीमाएं दर्ज करते हैं, जिनमें कम से कम दो वर्ष का अंतर होना चाहिए और जिन्हें वर्ष में एक बार बदला जा सकता है। वे डिफ़ॉल्ट प्रतिक्रिया को ओवरराइड करती हैं।[3]
| निर्धारित न्यूनतम आयु | लौटाई गई श्रेणियां | शीर्ष बैंड |
|---|---|---|
| कोई नहीं (डिफ़ॉल्ट) | 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 |
Google की रिस्पॉन्स गाइड से उदाहरण।[3]
उदाहरण
आप 13 और 17 सेट करते हैं। अब 25 वर्ष का व्यक्ति 17 / null लौटाता है, ठीक 17 वर्ष के व्यक्ति की तरह। कोड जो null ageUpper को वयस्क पढ़ता है, वह 17 वर्ष के उपयोगकर्ताओं को 18+ सुविधा में जाने देता है, इसलिए यदि आप 18 पर गेट करते हैं तो अपनी सूची में 18 रखें। प्रलेखित सीमाएं 18 पर समाप्त होती हैं[3]: यह API 21 वर्ष के गेट का उत्तर नहीं दे सकती है।
महत्वपूर्ण परिवर्तन और निरस्त अनुमोदन
दोनों सुविधाएं पर्यवेक्षित उपयोगकर्ताओं के लिए हैं। कौन सा कानून किसी परिवर्तन को महत्वपूर्ण बनाता है यह आपका निर्णय है, Play का नहीं[8]; राज्य के नियम App Store Accountability Acts में हैं।
आप Play को सूचित करते हैं
महत्वपूर्ण परिवर्तन
- अधिकतम 3 परिवर्तन, 90 दिन पहले तक, 2 दिनों से अधिक के अंतराल पर
- अंग्रेजी विवरण आवश्यक है, जो माता-पिता को शब्दशः दिखाया जाता है
significantChangeStatusAPPROVED, PENDING या DECLINED होता है- आपके ऐप को बदले गए फीचर को प्रतिबंधित करना होगा
संचयी: एक अनुमोदन सभी लंबित परिवर्तनों को कवर करता है[8]
Play आपको सूचित करता है
निरस्त अनुमोदन
installIdप्रति उपयोगकर्ता और डिवाइस होती है, और रीसेट के बाद नहीं बचती है- आप इसे केवल इसी उद्देश्य के लिए अपने बैकएंड पर संग्रहीत कर सकते हैं
- निरस्त IDs Play Console में CSV के रूप में दिखाई देती हैं
- प्रत्येक प्रविष्टि 90 दिनों के बाद हटा दी जाती है, इसलिए एक निश्चित शेड्यूल पर डाउनलोड करें
एक ID एक से अधिक बार दिखाई दे सकती है[9]
PENDING और DECLINED होने पर बदले गए फ़ीचर पर रोक लगाएं, पूरे ऐप पर नहीं। बिना पर्यवेक्षण वाले खातों के लिए और बिना किसी दर्ज परिवर्तन वाले पर्यवेक्षित खातों के लिए स्टेटस null होता है।[3]
त्रुटियां और असमर्थित डिवाइस
विफलताएं AgeSignalsException के रूप में प्राप्त होती हैं। Google अधिकतम प्रयासों की संख्या के साथ पुनः प्रयास करने की सलाह देता है।[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)
}
| कोड | कॉन्स्टेंट | पुनः प्रयास करें | कार्रवाई |
|---|---|---|---|
| -1, -6 | API_NOT_AVAILABLE, PLAY_STORE_VERSION_OUTDATED | हाँ | Play Store को अपडेट करने के लिए कहें |
| -2 | PLAY_STORE_NOT_FOUND | हाँ | Play Store को इंस्टॉल या सक्षम करने के लिए कहें |
| -3 | NETWORK_ERROR | हाँ | कनेक्शन की जांच करने के लिए कहें |
| -4, -7 | PLAY_SERVICES_NOT_FOUND, PLAY_SERVICES_VERSION_OUTDATED | हाँ | Play Services को इंस्टॉल, सक्षम या अपडेट करने के लिए कहें |
| -5 | CANNOT_BIND_TO_SERVICE | हाँ | एक्सपोनेंशियल बैकऑफ़, फिर Play Store को अपडेट करें |
| -8 | CLIENT_TRANSIENT_ERROR | हाँ | कैप्ड पुनः प्रयास, फिर बाद में प्रयास करें |
| -9 | APP_NOT_OWNED | नहीं | Google Play द्वारा इंस्टॉल नहीं किया गया: साइडलोड या अन्य स्टोर |
| -10 | SDK_VERSION_OUTDATED | नहीं | एक नई लाइब्रेरी जारी करें |
| -11 | DEVICE_NOT_SUPPORTED | नहीं | डिवाइस प्रकार समर्थित नहीं है; 0.0.6 में नया[4] |
| -100 | INTERNAL_ERROR | नहीं | Google का टेक्स्ट अभी भी कैप्ड पुनः प्रयासों का सुझाव देता है; ऊपर दिया गया कोड इसका पुनः प्रयास नहीं करता है |
Google का त्रुटि कोड संदर्भ।[7] एक त्रुटि कोई आयु नहीं है: डिफ़ॉल्ट अनुभव पर वापस जाएं।
0.0.3 और 0.0.4 से माइग्रेट करें
वर्जन 0.0.3 अभी भी प्रतिक्रियाएं लौटाता है लेकिन इसे कोई अपडेट नहीं मिलता है।[12] इससे आगे बढ़ना रीड पाथ को फिर से लिखना है; 0.0.4 से यह छोटा है।
| आपके कोड में | 0.0.6 में | से |
|---|---|---|
केवल checkAgeSignals | पहले requestAgeSignalsAccess[4] | 0.0.3 |
userStatus() | हटा दिया गया: ageRangeSource() और significantChangeStatus()[4] | 0.0.3 |
VERIFIED | TIER_C या TIER_D (हमारा आकलन) | 0.0.3 |
DECLARED | TIER_A, या यदि कोई अभिभावक इसे प्रबंधित करता है तो TIER_B (हमारा आकलन) | 0.0.3 |
SUPERVISED | TIER_B (हमारा आकलन) | 0.0.3 |
SUPERVISED_APPROVAL_PENDING, SUPERVISED_APPROVAL_DENIED | PENDING या DECLINED के साथ TIER_B (हमारा आकलन) | 0.0.3 |
UNKNOWN, null | एक्सेस स्थिति: VERIFICATION_REQUIRED या NOT_SHARED (हमारा आकलन) | 0.0.3 |
mostRecentApprovalDate() | significantChangeApprovalDate()[4] | 0.0.3 |
| दो कॉल, टियर्स | अपरिवर्तित; यदि उपयोगी हो तो getApplicableAgeFeatures जोड़ें[4] | 0.0.4 |
| त्रुटि प्रबंधन | DEVICE_NOT_SUPPORTED जोड़ें[4] | दोनों |
minSdk 23 | लाइब्रेरी 24 घोषित करती है[11] | दोनों |
Google कोई मान-दर-मान मैपिंग प्रकाशित नहीं करता है। "हमारा आकलन" चिह्नित पंक्तियाँ दोनों परिभाषाओं की तुलना करने से आती हैं।[3][12]
ध्यान दें
पुराने AgeSignalsVerificationStatus स्थिरांक अभी भी 0.0.6 में शामिल हैं, इसलिए इम्पोर्ट्स संकलित हो जाते हैं जबकि userStatus() मौजूद नहीं है।[11] 0.0.3 में, VERIFIED 0 था; 0.0.6 में, 0 का अर्थ UNSPECIFIED है।[10][11] अपग्रेड करते समय कैश्ड पूर्णांकों को साफ़ करें।
FakeAgeSignalsManager और लाइसेंस परीक्षकों के साथ परीक्षण करें
FakeAgeSignalsManager कभी भी Play Store से संचार नहीं करता है; इसका संदर्भ इसे यूनिट परीक्षणों और शुरुआती विकास तक सीमित करता है।[32] मैनेजर को इंजेक्ट करें ताकि आप इसे बदल सकें।
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)
)
- प्रत्येक स्थिति, एक नाबालिग बैंड, एक वयस्क बैंड, null सीमाएं और प्रति कॉल एक त्रुटि को कवर करें (
setNextRequestAgeSignalsAccessExceptionऔरsetNextApplicableAgeFeaturesExceptionअन्य दो को विफल करते हैं)। - लाइसेंस परीक्षक के साथ लाइव कॉल चलाएं: आमतौर पर Play द्वारा अपडेट न किए गए ऐप को
APP_NOT_OWNEDमिलता है; परीक्षक डिबग बिल्ड को साइडलोड कर सकते हैं।[6] - पैकेज का नाम Play ऐप के समान रखें और परीक्षक खाते से साइन इन करें।[6]
Flutter, React Native, Expo और Unity
ये कम्युनिटी या फ्रेमवर्क पैकेज हैं, Google के नहीं, और किसी को सूचीबद्ध करना कोई सिफारिश नहीं है। शिप करने से पहले लाइब्रेरी संस्करण की जांच करें।
| स्टैक | पैकेज की जांच की गई | लाइब्रेरी | रिलीज़ करने से पहले जानें |
|---|---|---|---|
| Expo | expo-age-range 58.0.3 | 0.0.4 | वेब पर और 26 से पहले के iOS पर यह किसी वयस्क की तरह lowerBound: 18 लौटाता है[17] |
| React Native | react-native-play-age-range-declaration 3.0.5 | 0.0.4 | अन्य स्टोर और Apple को भी रैप करता है[19] |
| Flutter | age_range_signals 0.10.1 | 0.0.4 | दो-कॉल फ़्लो, लाइसेंस टेस्टर समर्थन[18] |
| Unity | unity-play-age-signals | 0.0.4 | GPL-3.0; कॉलबैक मेन थ्रेड से बाहर चल सकते हैं[20] |
प्रत्येक पैकेज पेज या बिल्ड फ़ाइल से 22 नवंबर 2026 को पढ़ा गया।[17][18][19][20] Unity के कर्मचारियों ने दिसंबर 2025 में लिखा था कि Unity कोई समर्पित प्लगइन जारी नहीं करेगा।[21]
0.0.4 पर मौजूद पैकेज में getApplicableAgeFeatures और DEVICE_NOT_SUPPORTED नहीं है। यदि आपको उनकी आवश्यकता है, तो एक छोटा नेटिव ब्रिज लिखें। Apple पक्ष की तुलना Play Age Signals बनाम Apple Declared Age Range में की गई है।
लॉग न करें, साझा न करें या प्रोफ़ाइल न बनाएं
Google की शर्तें इस जानकारी को अनुरोध करने वाले ऐप में कानूनों के अनुपालन में आयु-उपयुक्त अनुभवों तक सीमित करती हैं।[5] नीति विज्ञापन, एनालिटिक्स, प्रोफाइलिंग, और कानून द्वारा कड़ाई से आवश्यक होने के अलावा किसी भी तीसरे पक्ष को डेटा बेचने, साझा करने या स्थानांतरित करने पर रोक लगाती है।[13]
- बैंड, टियर और
installIdको लॉग, क्रैश रिपोर्ट और एनालिटिक्स इवेंट्स से बाहर रखें: वे उपकरण आमतौर पर तीसरे पक्ष के होते हैं। - जहां संभव हो, रॉ रिज़ल्ट को मेमोरी में रखें, और टियर के बजाय फ़ीचर से जुड़े निर्णय को स्टोर करें।
- सिग्नल को कभी भी किसी आयु सत्यापन वेंडर से न जोड़ें, जिसमें Didit भी शामिल है।
- कैलिफ़ोर्निया में, उपयोगकर्ताओं से उनकी आयु की जानकारी बदलने का आग्रह न करें, और किसी तीसरे पक्ष के साथ ऐसे उद्देश्य के लिए कोई सिग्नल साझा न करें जिसकी आवश्यकता इस अधिनियम में नहीं है।[15]
- प्रत्येक उपयोगकर्ता के लिए सिग्नल का अनुरोध करने से पहले कानूनी सलाहकार से परामर्श लें: कैलिफ़ोर्निया का अधिनियम ऐसे अनुरोधों पर रोक लगाता है जिनकी मांग न तो यह अधिनियम करता है और न ही कोई अन्य लागू कानून।[15]
इसलिए “Play Store पर जाएं” संदेश VERIFICATION_REQUIRED के लिए है, न कि उस कैलिफ़ोर्नियाई उपयोगकर्ता के लिए जिसके बैंड पर आपको संदेह है। Google का क्षेत्रीय पेज कैलिफ़ोर्निया और ब्राज़ील को जनवरी 2027 से अनिवार्य और अलाबामा को “विवरण जल्द ही आ रहा है” के रूप में सूचीबद्ध करता है।[16] कैलिफ़ोर्निया के कर्तव्य Digital Age Assurance Act गाइड में हैं।
सिग्नल के बाद: अपना स्वयं का सत्यापन शुरू करें
आपका ऐप तय करता है कि सत्यापन की आवश्यकता है; अनुरोध में एक वर्कफ़्लो और आपका उपयोगकर्ता ID होता है, Google का उत्तर कभी नहीं। अपने सर्वर से Didit को कॉल करें, क्योंकि API कुंजी डिवाइस तक नहीं पहुंचनी चाहिए।
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"
}'
201 रिस्पॉन्स में session_id, session_token और url होते हैं।[25] ऐप को केवल टोकन भेजें, फिर 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()
}
}
SDK रिज़ल्ट इंटरफ़ेस के लिए है। हस्ताक्षरित status.updated वेबहुक से निर्णय लें, या अपने सर्वर से GET /v3/session/{sessionId}/decision/ पढ़ें।[25][29] रद्दीकरण और विफलता पर सुरक्षित डिफ़ॉल्ट बनाए रखें।
सीमाएं जानें
जहां सिग्नल पर्याप्त हो, वहां इस चरण को छोड़ दें। अपनी स्वयं की जांच हमेशा बेहतर नहीं होती। अलाबामा और यूटा के अधिनियम, जिनके कर्तव्य 2027 से हैं, उन सुरक्षा उपायों के लिए सबसे निचली आयु श्रेणी का उपयोग करते हैं जिन्हें वे कवर करते हैं, और ब्राज़ील अधिक सुरक्षात्मक विकल्प का उपयोग करता है, इसलिए वहां जांच केवल सुरक्षा को और कड़ा कर सकती है।[22][23][24] इलिनोइस, टेक्सास या कोलोराडो कानून द्वारा कवर किए गए लोगों को सेल्फ़ी से पहले बायोमेट्रिक सहमति चरण की आवश्यकता होती है, जिसे नेटिव SDK 4.10.0 या बाद का संस्करण दिखा सकता है।[28] कानूनी सलाहकार से पुष्टि करें कि आपके ऐप पर कौन सा नियम लागू होता है।
सिग्नल के बाद Didit कैसे मदद करता है
Didit Age Estimation एक सेल्फ़ी से आयु का अनुमान लगाता है, उसी चरण में लाइवनेस की जांच करता है, और यह नहीं बताता कि व्यक्ति कौन है। एक वर्कफ़्लो आपके द्वारा निर्धारित सीमावर्ती बैंड को दस्तावेज़ जांच के लिए भेज सकता है।[27] Age Estimation की लागत प्रति कॉल $0.10 है; मूल्य निर्धारण देखें।

Didit कंसोल में आयु अनुमान परिणाम (नमूना डेटा): दस्तावेज़ पर दर्ज आयु के बगल में सेल्फ़ी से प्राप्त अनुमान।
Android, iOS, React Native और Flutter के लिए नेटिव SDK उपलब्ध हैं। Unity और अन्य इंजनों के लिए प्रलेखित मार्ग WebView इंटीग्रेशन है।[31] Google Play से बाहर के सरफ़ेस आयु सत्यापन API: ऐप्स, वेब और स्टोर्स और आयु सत्यापन समाधान पृष्ठ पर शामिल हैं।
Didit प्रदान करता है
- सेल्फी, लाइवनेस और एक वैकल्पिक दस्तावेज़ चरण के साथ एक होस्टेड आयु जांच
- एक ISO/IEC 27566-1 वर्कफ़्लो विकल्प जो न्यूनतम 13 वर्ष की आयु से, आयु के बारे में हाँ या नहीं का निर्णय देता है और कोई व्यक्तिगत डेटा नहीं देता[27]
- रिटेंशन विंडो, लौटाए गए डेटा के स्विच और एक डिलीट कॉल[30]
आपके पास रहता है
- Play Age Signals कॉल और उसका परिणाम
- कौन सा कानून लागू होता है और क्या जांच की आवश्यकता है या नहीं
- आयु-उपयुक्त डिफ़ॉल्ट और अंतिम एक्सेस निर्णय
Didit के पास कोई Play Age Signals कनेक्टर नहीं है: सिग्नल आपके ऐप में ही रहता है।
अपने ऐप में फ़ॉलबैक ब्रांच को चलते हुए देखें
अपना आयु गेट, अपने बाज़ार और अपना स्टैक लाएं, या वर्कफ़्लो स्वयं बनाएं।
मुख्य निष्कर्ष
- 0.0.6 का उपयोग करें: वैकल्पिक फ़ीचर्स कॉल, एक्सेस अनुरोध, फिर केवल
SHAREDपरcheckAgeSignals। ageLowerपर गेट करें; nullageUpperका अर्थ शीर्ष बैंड है, और कस्टम आयु सीमाएं इसे 18 से नीचे ले जा सकती हैं।- null सीमाएं,
UNSPECIFIEDऔर त्रुटियां कोई सिग्नल नहीं हैं; इन्हें कभी वयस्क न मानें। - 0.0.6 मेनिफ़ेस्ट minSdk 24 घोषित करता है।
- सिग्नल को अपने ऐप में रखें और इसके बिना अपनी कोई भी जांच शुरू करें।
अक्सर पूछे जाने वाले प्रश्न
मुझे Play Age Signals API के किस संस्करण का उपयोग करना चाहिए?
0.0.6 का उपयोग करें। यह वर्तमान संस्करण है, जो विश्व स्तर पर उपलब्ध है, और Google का कहना है कि यह 11 दिसंबर 2026 तक सभी उपयोगकर्ताओं के लिए प्रतिक्रियाएं लौटाएगा; इस बीच 0.0.4 चयनित क्षेत्रों में प्रतिक्रियाएं लौटाना जारी रखता है।[2]
क्या मुझे getApplicableAgeFeatures को कॉल करने की आवश्यकता है?
नहीं, Google इसे वैकल्पिक के रूप में चिह्नित करता है। इसे तब कॉल करें जब आपकी अपनी स्क्रीन उस उपयोगकर्ता के लिए भिन्न होनी चाहिए जिसके लिए साझाकरण अनिवार्य है।[2]
NOT_SHARED और VERIFICATION_REQUIRED के बीच क्या अंतर है?
NOT_SHARED का अर्थ है कि आपके ऐप को कोई आयु सिग्नल नहीं मिलता क्योंकि उपयोगकर्ता या माता-पिता साझा करने के लिए सहमत नहीं हुए। VERIFICATION_REQUIRED का अर्थ है कि उस क्षेत्र में आयु सत्यापित नहीं है जहां सत्यापन और साझाकरण दोनों अनिवार्य हैं, और Google आपको उपयोगकर्ता से Play Store पर जाने के लिए कहने का निर्देश देता है।[2]
दोनों सीमाएं null क्यों हैं?
जब स्टेटस NOT_SHARED या VERIFICATION_REQUIRED होता है, तब रिस्पॉन्स संदर्भ null सीमाएं देता है।[3] null सीमाओं को कोई सिग्नल न होने के रूप में मानें, और कभी भी वयस्क के रूप में नहीं।
वयस्कों के लिए ageUpper null क्यों है?
क्योंकि शीर्ष बैंड ओपन-एंडेड है: 18+ के लिए ageLower 18 और ageUpper null रिटर्न होता है।[3] कस्टम आयु के साथ शीर्ष बैंड निचले स्तर से शुरू हो सकता है, इसलिए ageLower की तुलना अपनी न्यूनतम आयु से करें।
क्या मैं अपनी स्वयं की आयु सीमाएं सेट कर सकता हूं?
हाँ, Play Console में Age signals पेज पर अधिकतम तीन न्यूनतम आयु सीमाएं, कम से कम दो वर्ष के अंतराल पर, वर्ष में एक बार बदली जा सकती हैं। वे डिफ़ॉल्ट श्रेणियों को ओवरराइड करती हैं।[3]
कानून लागू होने से पहले मैं परीक्षण कैसे करूं?
MANDATORY_SHARING सहित किसी भी स्टेटस, रेंज या त्रुटि को रिटर्न करने के लिए FakeAgeSignalsManager का उपयोग करें। एक लाइसेंस टेस्टर अकाउंट साइडलोडेड डिबग बिल्ड को लाइव API कॉल करने की अनुमति देता है।[6]
क्या यह Trusted Web Activity या WebView में काम करता है?
वेब कोड से नहीं। यह एक Activity के साथ कॉल की जाने वाली Android लाइब्रेरी है, और हमारे द्वारा पढ़े गए Google पेजों में किसी वेब इंटरफ़ेस का उल्लेख नहीं है। एक रैपर ऐप को अपने स्वयं के नेटिव कोड की आवश्यकता होगी, और Google की शर्तें जानकारी को केवल अनुरोध करने वाले ऐप तक सीमित करती हैं।[2][5]
क्या कोई Unity, Flutter या React Native प्लगइन उपलब्ध है?
कम्युनिटी और फ्रेमवर्क पैकेज उपलब्ध हैं। 22 नवंबर 2026 को हमने जिनकी जांच की, वे 0.0.4 घोषित करते हैं, इसलिए उनमें getApplicableAgeFeatures नहीं है। Unity कर्मचारियों ने दिसंबर 2025 में कहा था कि Unity कोई समर्पित प्लगइन जारी नहीं करेगा।[17][18][19][20][21]
क्या मैं परिणाम को अपने सर्वर पर स्टोर कर सकता हूं?
Google के पेज स्पष्ट रूप से निरस्तीकरण नोटिस के लिए आपके बैकएंड पर installId स्टोर करने का विवरण देते हैं। बाकी के लिए, अपने सिस्टम के भीतर केवल उतना ही न्यूनतम परिणाम रखें जितना आपके कानूनी दायित्व के लिए आवश्यक हो, और एनालिटिक्स, विज्ञापन या किसी तीसरे पक्ष की सेवा में कभी नहीं, जब तक कि कानून द्वारा सख्ती से इसकी आवश्यकता न हो।[9][13]
स्रोत
- Play Age Signals API (beta) का उपयोग करें, Android Developers, 19 नवंबर 2026 को अपडेट किया गया।
- आयु सिग्नल का अनुरोध करें, Android Developers, 18 नवंबर 2026 को अपडेट किया गया।
- आयु सिग्नल रिस्पॉन्स को समझें, Android Developers, 18 नवंबर 2026 को अपडेट किया गया।
- Play Age Signals रिलीज़ नोट्स, Android Developers, 19 नवंबर 2026 को अपडेट किया गया।
- Play Age Signals अवलोकन और सेवा की शर्तें, Android Developers, 18 नवंबर 2026 को अपडेट किया गया।
- अपने Play Age Signals API (beta) एकीकरण का परीक्षण करें, Android Developers, 19 नवंबर 2026 को अपडेट किया गया।
- Play Age Signals API त्रुटि कोड संदर्भ, Android Developers, 18 नवंबर 2026 को अपडेट किया गया।
- महत्वपूर्ण परिवर्तनों के बारे में Google Play को सूचित करें, Android Developers, 4 सितंबर 2026 को अपडेट किया गया।
- निरस्त किए गए ऐप अनुमोदनों की समीक्षा करें, Android Developers, 4 सितंबर 2026 को अपडेट किया गया।
- AgeRangeSource संदर्भ, Android Developers, 18 नवंबर 2026 को अपडेट किया गया।
- com.google.android.play:age-signals, Google Maven; 22 नवंबर 2026 को पढ़े गए वर्ज़न 0.0.3, 0.0.4 और 0.0.6 के लाइब्रेरी मैनिफ़ेस्ट और क्लासेस।
- Play Age Signals API का उपयोग करें, वर्ज़न 0.0.3, Android Developers, 23 अक्टूबर 2026 को अपडेट किया गया।
- Age Signals API और उपयोगकर्ता डेटा नीति, Google Play Console Help.
- Google Play पर आयु श्रेणी साझा करने के बारे में, Google Play Help.
- AB 1856, Chapter 184, Statutes of 2026, California Legislative Information; Civil Code 1798.500 से 1798.504 में संशोधन करता है।
- Play पर क्षेत्रीय आयु-संबंधी सुरक्षा, Android Developers, 18 नवंबर 2026 को अपडेट किया गया।
- Expo AgeRange, Expo दस्तावेज़; पैकेज expo-age-range 58.0.3.
- age_range_signals, pub.dev, संस्करण 0.10.1, 6 अक्टूबर 2026.
- react-native-play-age-range-declaration, GitHub, संस्करण 3.0.5.
- unity-play-age-signals, GitHub, 4 अगस्त 2026 को अपडेट किया गया.
- Play Age Signals API Support, Unity Discussions, Unity स्टाफ का उत्तर, दिसंबर 2025.
- Code of Alabama 8-19K-9 (HB 161), Alabama Legislature.
- Utah Code 13-76-202, Utah Legislature; 6 मई 2027 से डेवलपर के कर्तव्य.
- 18 मार्च 2026 का Decreto 12.880, अनुच्छेद 25, Planalto, Brazil.
- सत्र बनाएं, Didit दस्तावेज़.
- Android SDK, Didit दस्तावेज़.
- Age Estimation अवलोकन, Didit दस्तावेज़.
- बायोमेट्रिक सहमति, Didit दस्तावेज़.
- वेबहुक, Didit दस्तावेज़.
- डेटा प्रतिधारण, Didit दस्तावेज़.
- Native SDKs अवलोकन, Didit दस्तावेज़.
- FakeAgeSignalsManager संदर्भ, Android Developers, 18 नवंबर 2026 को अपडेट किया गया.
तीनों कॉल्स को रिलीज़ करें, तालिका की प्रत्येक पंक्ति का परीक्षण करें, और सिग्नल को वहीं रखें जहां Google की शर्तें इसे छोड़ती हैं: आपके ऐप में। जिन शाखाओं का यह उत्तर नहीं दे सकता, उनके लिए अपनी स्वयं की जांच के रूप में आयु अनुमान जोड़ें।
बिना सिग्नल वाले उपयोगकर्ताओं के लिए जांच जोड़ें
अपने ऐप में आयु अनुमान का डेमो प्राप्त करें, या एक वर्कफ़्लो बनाएं और आज ही एक सत्र शुरू करें।
संबंधित लेख
- Google Play Age Signals API: what changes in January 2027
- Age assurance for apps: games, social, dating, AI and more
- Age verification API: which one works on apps, web and stores
- Brazil's ECA Digital and Google Play: age signals in your app
- California age verification law 2027: the four rules for apps
- App Store Accountability Acts: Texas, Utah, Louisiana, Alabama