استفاده از 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.
          }
        });

(اختیاری) دریافت گروه‌های سنی سفارشی

گروه‌های سنی پیش‌فرض که API در حوزه‌های قضایی و مناطق ذی‌ربط برمی‌گرداند عبارت‌اند از ‎۰-۱۲،‏ ۱۳-۱۵،‏ ۱۶-۱۷، و +۱۸.

یا برای سفارشی‌سازی کردن گروه‌های سنی پیش‌فرض براساس حداقل سن‌های برنامه‌تان، می‌توانید این حداقل سن‌ها را برای برنامه‌تان در صفحه نشان‌های سن در «کنسول Google Play» ارائه دهید.

1. به صفحه نشان‌های سن در «کنسول Play» بروید.
2. در برگه گروه‌های سنی سفارشی، حداکثر سه حداقل سن برای برنامه‌تان وارد کنید. حداقل سن‌ها باید حداقل ۲ سال باهم فاصله داشته باشند و می‌توان آن‌ها را سالی یک‌بار تغییر داد.
3. روی ذخیره کلیک کنید.

گروه‌های سنی برگردانده‌شده پاسخ پیش‌فرض میانای برنامه‌سازی کاربردی را لغو خواهد کرد. برای مثال:

• اگر یک حداقل سن (۱۵) در «کنسول Google Play» تنظیم کنید:

  • برای سنین ۰ تا ۱۴ سال، ageLower = 0 و ageUpper = 14 را برمی‌گرداند.
  • فردی که ۱۵ سال یا بیشتر دارد، ageLower = 15 را برمی‌گرداند.

• اگر دو حداقل سن (۱۳ و ۱۷) تنظیم کنید:

  • برای کودک ۰ تا ۱۲ ساله، ageLower = 0 و ageUpper = 12 برگردانده می‌شود.
  • برای فرد ۱۳ تا ۱۶ ساله، ageLower = 13 و ageUpper = 16 برگردانده می‌شود.
  • فردی ۱۷ سال به بالا، ageLower = 17 را برمی‌گرداند.

• اگر سه حداقل سن (۱۱، ۱۳، و ۱۵) تنظیم کنید:

  • برای کودک ۰ تا ۱۰ ساله، ageLower = 0 و ageUpper = 10 برگردانده می‌شود.
  • برای ۱۱ یا ۱۲ ساله‌ها، ageLower = 11 و ageUpper = 12 برگردانده می‌شود.
  • ‫۱۳ یا ۱۴ ساله، ageLower = 13 و ageUpper = 14 را برمی‌گرداند.
  • برای فردی که ۱۵ سال یا بیشتر دارد، ageLower = 15 برگردانده می‌شود.

پاسخ‌های نشان‌های سن

پاسخ Play Age Signals API (نسخه بتا) شامل فیلدها و مقادیر زیر است. مقادیر ممکن است تغییر کنند. اگر جدیدترین مقادیر را می‌خواهید، هنگام باز شدن برنامه‌تان، پاسخ میانای برنامه‌سازی کاربردی را درخواست کنید. شما مسئول ارائه تجربه‌های مناسب سن کاربر بااستفاده از این نشان‌ها هستید.

پاسخ‌های نمونه برای کاربران در برزیل

در برزیل، userStatus فقط می‌تواند DECLARED، UNKNOWN، یا null باشد.

برای کاربری که سن خود را اعلام کرده و آن را با برنامه‌ها هم‌رسانی می‌کند، موارد زیر را دریافت خواهید کرد:

• userStatus AgeSignalsVerificationStatus.DECLARED خواهد بود.
• ageLower یک عدد خواهد بود (برای مثال، ۱۳).
• ageUpper باید عدد یا null باشد (برای مثال، ۱۵).
• فیلدهای پاسخ دیگر null خواهد بود.

برای کاربری که سنش مشخص نیست، موارد زیر را دریافت می‌کنید:

• userStatus AgeSignalsVerificationStatus.UNKNOWN خواهد بود.
• فیلدهای پاسخ دیگر null خواهد بود.

برای کاربری که سنش با برنامه‌ها هم‌رسانی نمی‌شود، موارد زیر را دریافت خواهید کرد:

• userStatus null خواهد بود.
• فیلدهای پاسخ دیگر null خواهد بود.

وقتی سن کاربر برای هم‌رسانی دردسترس باشد، وضعیت کاربر می‌تواند به DECLARED تغییر کند.

پاسخ‌های نمونه برای کاربران در ایالت‌های امریکا

در ایالت‌های ذی‌ربط ایالات متحده، userStatus می‌تواند VERIFIED، SUPERVISED، SUPERVISED_APPROVAL_PENDING، SUPERVISED_APPROVAL_DENIED، UNKNOWN، یا null باشد.

برای کاربر تأییدشده، موارد زیر را دریافت می‌کنید:

• userStatus AgeSignalsVerificationStatus.VERIFIED خواهد بود.
• ageLower یک عدد خواهد بود (برای مثال، ۱۸).
• ageUpper عددی خواهد بود یا null (برای مثال، null).
• فیلدهای پاسخ دیگر null خواهد بود.

برای کاربر تحت نظارت، موارد زیر را دریافت خواهید کرد:

• userStatus AgeSignalsVerificationStatus.SUPERVISED خواهد بود.
• ageLower یک عدد خواهد بود (برای مثال، ۱۳).
• ageUpper باید عدد یا null باشد (برای مثال، ۱۵).
• mostRecentApprovalDate یک شیء تاریخ Java خواهد بود (برای مثال، 2026-01-01) یا null (اگر هیچ تغییر قابل‌توجهی تأیید نشده باشد).
• installID شناسه الفباعددی تولیدشده توسط Play خواهد بود (برای مثال، 550e8400-e29b-41d4-a716-446655441111).

برای کاربر تحت نظارتی که تأییدیه تغییر مهم او درانتظار است، موارد زیر را دریافت خواهید کرد:

• userStatus AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING خواهد بود.
• ageLower یک عدد خواهد بود (برای مثال، ۱۳).
• ageUpper باید عدد یا null باشد (برای مثال، ۱۵).
• mostRecentApprovalDate یک شیء تاریخ Java خواهد بود (برای مثال، 2026-01-01) یا null (اگر هیچ تغییر قابل‌توجهی تأیید نشده باشد).
• installID شناسه الفباعددی تولیدشده توسط Play خواهد بود (برای مثال، 550e8400-e29b-41d4-a716-446655441111).

رسیدگی به کدهای خطای میانای برنامه‌سازی کاربردی

اگر برنامه‌تان درخواست Play Age Signals API ارائه دهد و فراخوانی ناموفق باشد، برنامه‌تان کد خطا دریافت می‌کند. این خطاها ممکن است به‌دلایل مختلفی رخ دهد، مثلاً قدیمی بودن برنامه «فروشگاه Play».

استراتژی امتحان مجدد

در شرایطی که کاربر در جلسه است، توصیه می‌کنیم راهبرد تلاش مجدد را با حداکثر تعداد تلاش به‌عنوان شرط خروج اجرا کنید تا خطا کمترین اختلال را در تجربه کاربر ایجاد کند.