Play Age Signals API (बीटा वर्शन) का इस्तेमाल करना

// Create an instance of a manager
val ageSignalsManager =
    AgeSignalsManagerFactory.create(ApplicationProvider.getApplicationContext())

// Request an age signals check
ageSignalsManager
    .checkAgeSignals(AgeSignalsRequest.builder().build())
    .addOnSuccessListener { ageSignalsResult ->
        // Store the install ID for later...
        val installId = ageSignalsResult.installId()

        if (ageSignalsResult.userStatus() == AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_DENIED) {
          // Disallow access...
        } else {
           // Do something else if the user is SUPERVISED, VERIFIED, etc.
        }
    }

// Create an instance of a manager
AgeSignalsManager ageSignalsManager =
    AgeSignalsManagerFactory.create(ApplicationProvider.getApplicationContext());

// Request an age signals check
ageSignalsManager
    .checkAgeSignals(AgeSignalsRequest.builder().build())
    .addOnSuccessListener(
        ageSignalsResult -> {
          // Store the install ID for later...
          String installId = ageSignalsResult.installId();

          if (ageSignalsResult
              .userStatus()
              .equals(AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_DENIED)) {
            // Disallow access ...
          } else {
            // Do something else if the user is SUPERVISED, VERIFIED, etc.
          }
        });

Google Play, हर उपयोगकर्ता के लिए डिवाइस पर उम्र से जुड़े सिग्नल सेव करता है. जब उम्र बढ़ने की वजह से, निगरानी में रखे गए Google खाते का इस्तेमाल करने वाला कोई व्यक्ति, उम्र के नए दायरे में आ जाता है, तो Google Play उसके जन्मदिन के दो से आठ हफ़्तों के अंदर, उस व्यक्ति के लिए कैश मेमोरी में सेव किए गए उम्र के सिग्नल को अपने-आप अपडेट कर देता है.

(ज़रूरी नहीं) पसंद के मुताबिक उम्र की सीमाओं का डेटा

Play Age Signals API, लागू होने वाले देशों/इलाकों और अधिकार क्षेत्रों में डिफ़ॉल्ट तौर पर उम्र की कुछ सीमाएं दिखाता है. ये सीमाएं हैं: 0 से 12 साल, 13 से 15 साल, 16 से 17 साल, और 18 साल से ज़्यादा. स्थानीय ज़रूरी शर्त के आधार पर, आने वाले समय में इनमें बदलाव किए जा सकते हैं.

इसके अलावा, दिखाई जाने वाली उम्र की सीमाओं को ऐप्लिकेशन के लिए तय की गई कम से कम उम्र के हिसाब से पसंद के मुताबिक बनाया जा सकता है. इसके लिए, Google Play Console में उम्र से जुड़े सिग्नल पेज पर जाकर, ऐप्लिकेशन इस्तेमाल करने वालों की कम से कम उम्र तय करें. Age Signals API, पसंद के मुताबिक बनाई गई उम्र की सीमाएं दिखाता है. उदाहरण के लिए, अगर आपने 9, 15, और 17 साल की कैटगरी चुनी है, तो ऐप्लिकेशन इस्तेमाल करने वाला ऐसा उपयोगकर्ता जिसकी उम्र 14 साल है, वह 10 से 15 साल की उम्र सीमा में आएगा.

Age Signals API से मिलने वाले जवाब में शामिल उम्र सीमाओं को पसंद के मुताबिक बनाने के लिए, आपका ऐप्लिकेशन इस्तेमाल करने के लिए कम से कम उम्र तय करें. ऐसा करने के लिए, यह तरीका अपनाएं:

1. Play Console में उम्र के हिसाब से सिग्नल पेज पर जाएं.
2. पसंद के मुताबिक तय की गई उम्र सीमाएं टैब पर जाकर, अपने ऐप्लिकेशन के लिए कम से कम तीन उम्र डालें. कम से कम उम्र की कैटगरी के बीच दो साल या इससे ज़्यादा का अंतर होना ज़रूरी है. इसे साल में एक बार बदला जा सकता है.
3. सेव करें पर क्लिक करें.

उम्र से जुड़े सिग्नल से मिलने वाली जानकारी

Play Age Signals API (बीटा वर्शन) से मिली जानकारी में, ये फ़ील्ड और वैल्यू शामिल होती हैं. इन वैल्यू में बदलाव हो सकता है. अगर आपको सबसे नई वैल्यू चाहिए, तो ऐप्लिकेशन खुलने पर एपीआई से जानकारी पाने का अनुरोध करें. इन सिग्नल का इस्तेमाल करके, उम्र के हिसाब से सही अनुभव उपलब्ध कराना आपकी ज़िम्मेदारी है.

जवाब के उदाहरण

पुष्टि किए गए उपयोगकर्ता के लिए आपको यह जानकारी मिलेगी:

• userStatus AgeSignalsVerificationStatus.VERIFIED होगी.
• जवाब के अन्य फ़ील्ड खाली होंगे.

निगरानी में रखे गए उपयोगकर्ता के लिए, आपको यह जानकारी मिलेगी:

• userStatus AgeSignalsVerificationStatus.SUPERVISED होगा.
• ageLower कोई संख्या होगी. जैसे, 13.
• ageUpper कोई संख्या होगी. जैसे, 15.
• mostRecentApprovalDate एक Java डेट ऑब्जेक्ट होगा (जैसे, 2026-01-01) या खाली होगा (अगर ज़रूरी बदलाव को मंज़ूरी नहीं मिली है).
• installID, Play से जनरेट किया गया अल्फ़ान्यूमेरिक आईडी होगा. जैसे, 550e8400-e29b-41d4-a716-446655441111.

निगरानी में रखे गए किसी ऐसे उपयोगकर्ता के लिए जिसके खाते में अहम बदलाव करने की अनुमति मिलना बाकी है, आपको ये सूचनाएं मिलेंगी:

• userStatus AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING होगा.
• ageLower कोई संख्या होगी. जैसे, 13.
• ageUpper कोई संख्या होगी. जैसे, 15.
• mostRecentApprovalDate एक Java डेट ऑब्जेक्ट होगा (जैसे, 2026-01-01) या खाली होगा (अगर ज़रूरी बदलाव को मंज़ूरी नहीं मिली है).
• installID, Play से जनरेट किया गया अल्फ़ान्यूमेरिक आईडी होगा. जैसे, 550e8400-e29b-41d4-a716-446655441111.

एपीआई के गड़बड़ी कोड मैनेज करना

अगर आपका ऐप्लिकेशन, Play Age Signals API के लिए अनुरोध करता है और कॉल पूरा नहीं होता है, तो आपके ऐप्लिकेशन को गड़बड़ी का कोड मिलता है. ये गड़बड़ियां कई वजहों से हो सकती हैं. जैसे, Play Store ऐप्लिकेशन का पुराना वर्शन इस्तेमाल किया जाना.

फिर से कोशिश करने की रणनीति

अगर उपयोगकर्ता सेशन में है, तो हमारा सुझाव है कि फिर से कोशिश करने की रणनीति लागू करें. इसमें, कोशिशों की ज़्यादा से ज़्यादा संख्या को एग्ज़िट की शर्त के तौर पर सेट करें, ताकि गड़बड़ी से उपयोगकर्ता अनुभव पर कम से कम असर पड़े.