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 उसके जन्मदिन के दो से आठ हफ़्तों के अंदर, उस व्यक्ति के लिए कैश मेमोरी में सेव किए गए उम्र के सिग्नल अपने-आप अपडेट कर देता है.

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

एपीआई, लागू होने वाले देशों/इलाकों और अधिकार क्षेत्रों में उम्र की कुछ डिफ़ॉल्ट सीमाएं दिखाता है. ये सीमाएं 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 ऐप्लिकेशन का पुराना वर्शन इस्तेमाल किया जा रहा हो.

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

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