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 VERIFIED, DECLARED, SUPERVISED, 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.
          }
        });

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

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

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

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

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

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

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

ब्राज़ील में रहने वाले उपयोगकर्ताओं के लिए जवाबों के उदाहरण

ब्राज़ील में, userStatus की वैल्यू सिर्फ़ DECLARED, UNKNOWN या null हो सकती है.

जिस उपयोगकर्ता ने अपनी उम्र बताई है और उसे ऐप्लिकेशन के साथ शेयर किया है उसके लिए, आपको यह जानकारी मिलेगी:

• userStatus AgeSignalsVerificationStatus.DECLARED होगी.
• ageLower कोई संख्या होगी. जैसे, 13.
• ageUpper कोई संख्या या null होगा. जैसे, 15.
• जवाब के अन्य फ़ील्ड null होंगे.

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

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

जिस उपयोगकर्ता की उम्र, ऐप्लिकेशन के साथ शेयर नहीं की जाती है उसके लिए आपको यह जानकारी मिलेगी:

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

जब उपयोगकर्ता की उम्र शेयर करने के लिए उपलब्ध होगी, तब उपयोगकर्ता की स्थिति DECLARED में बदल सकती है.

अमेरिका के राज्यों में रहने वाले उपयोगकर्ताओं के लिए जवाब के उदाहरण

अमेरिका के जिन राज्यों में यह सुविधा उपलब्ध है वहां userStatus की वैल्यू VERIFIED, SUPERVISED, SUPERVISED_APPROVAL_PENDING, SUPERVISED_APPROVAL_DENIED, UNKNOWN या null हो सकती है.

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

• userStatus AgeSignalsVerificationStatus.VERIFIED होगी.
• ageLower कोई संख्या होगी. उदाहरण के लिए, 18.
• ageUpper कोई संख्या या null होगा. उदाहरण के लिए, null.
• जवाब के अन्य फ़ील्ड null होंगे.

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

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

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

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

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

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

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

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