این اسناد قبل از صورت‌حساب‌های تأیید سن آتی در ایالت‌های مربوطه ایالات متحده که از اول ژانویه ۲۰۲۶ در تگزاس اجرا می‌شوند، به اشتراک گذاشته می‌شود. Play Age Signals API (بتا) پاسخ‌های زنده را برای کاربران قابل اجرا برمی‌گرداند و صفحه سیگنال‌های سنی پس از این تاریخ در Play Console در دسترس خواهد بود.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

استفاده از Play Age Signals API (بتا)

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

Play یک محدوده سنی را بر اساس باندهای سنی تعریف شده توسط حوزه قضایی و مناطق قابل اجرا برمی گرداند. سن‌های پیش‌فرض که API در حوزه‌های قضایی و مناطق قابل اجرا برمی‌گرداند 0-12، 13-15، 16-17 و 18+ است، اما این سنین ممکن است براساس الزامات منطقه‌ای تغییر کنند.

Play Age Signals API را در برنامه خود ادغام کنید

برای ادغام Play Age Signals API در برنامه خود، وابستگی زیر را به فایل build.gradle برنامه خود اضافه کنید:

implementation 'com.google.android.play:age-signals:0.0.1-beta01'

درخواست سیگنال سن

در اینجا نمونه ای از درخواست سیگنال سنی آورده شده است:

// 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 به طور خودکار سیگنال های سن ذخیره شده برای آن کاربر را ظرف 2 تا 8 هفته پس از تولد کاربر به روز می کند.

(اختیاری) محدوده سنی سفارشی را دریافت کنید

محدوده سنی پیش‌فرض که API در حوزه‌های قضایی و مناطق قابل اجرا برمی‌گرداند 0-12، 13-15، 16-17 و 18+ است. اینها ممکن است در آینده بر اساس نیازهای محلی تغییر کنند.

از طرف دیگر، برای سفارشی کردن محدوده‌های سنی با توجه به حداقل سن برنامه‌تان، می‌توانید این حداقل سن‌ها را برای برنامه خود در صفحه سیگنال‌های سنی در کنسول Google Play خود ارائه دهید. Age Signals API محدوده سنی سفارشی شده را برمی گرداند. به عنوان مثال، اگر حداقل سن 9، 15 و 17 را ارائه دهید، یک کاربر 14 ساله در محدوده سنی 10-15 قرار می گیرد. حداقل سن باید حداقل 2 سال از هم فاصله داشته باشد و سالی یک بار قابل تغییر باشد.

برای سفارشی کردن محدوده سنی بازگردانده شده توسط Age Signals API، می توانید حداقل سن را برای برنامه خود ارائه دهید:

به صفحه سیگنال های سن در کنسول Play خود بروید.
در برگه حداقل سن برنامه ، حداکثر سه سن حداقل را برای برنامه خود وارد کنید.
روی ذخیره کلیک کنید.

سن نشان دهنده پاسخ ها است

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

فیلد پاسخ	ارزش ها	توضیحات
`userStatus`	تأیید شد	کاربر بالای 18 سال سن دارد. Google با استفاده از روش تجاری معقول، مانند شناسه دولتی، کارت اعتباری، یا تخمین سن صورت، سن کاربر را تأیید کرد.
	تحت نظارت	کاربر دارای یک حساب Google تحت نظارت است که توسط والدینی که سن خود را تعیین می کند مدیریت می شود. برای تعیین محدوده سنی کاربر از `ageLower` و `ageUpper` استفاده کنید.
	SUPERVISED_APPROVAL_PENDING	کاربر دارای یک حساب Google تحت نظارت است و والدین ناظر او هنوز یک یا چند تغییر قابل توجه معلق را تأیید نکرده اند. برای تعیین محدوده سنی کاربر از `ageLower` و `ageUpper` استفاده کنید. از `mostRecentApprovalDate` برای تعیین آخرین تغییر مهم تایید شده استفاده کنید.
	SUPERVISED_APPROVAL_DENIED	کاربر دارای یک حساب Google تحت نظارت است و والدین ناظر او تأیید یک یا چند تغییر مهم را رد کردند. برای تعیین محدوده سنی کاربر از `ageLower` و `ageUpper` استفاده کنید. از `mostRecentApprovalDate` برای تعیین آخرین تغییر مهم تایید شده استفاده کنید.
	ناشناخته	کاربر در حوزه‌های قضایی و مناطق مربوطه تأیید یا نظارت نمی‌شود. این کاربران ممکن است بیش از 18 سال یا کمتر از آن داشته باشند. برای دریافت سیگنال سنی از Google Play، از کاربر بخواهید که به فروشگاه Play مراجعه کند تا وضعیت آنها مشخص شود.
	خالی (یک مقدار خالی)	همه کاربران دیگر این مقدار را برمی گردانند.
`ageLower`	0 تا 18	حد پایین (شامل) محدوده سنی کاربر تحت نظارت. برای تعیین محدوده سنی کاربر از `ageLower` و `ageUpper` استفاده کنید.
`ageLower`	خالی (یک مقدار خالی)	`userStatus` ناشناخته یا خالی است.
`ageUpper`	2 تا 18	حد بالایی (شامل) محدوده سنی کاربر تحت نظارت. برای تعیین محدوده سنی کاربر از `ageLower` و `ageUpper` استفاده کنید.
`ageUpper`	خالی (یک مقدار خالی)	یا `userStatus` تحت نظارت است و سن تأیید شده والدین کاربر بالای 18 سال است. یا `userStatus` تأیید شده، ناشناخته یا خالی است.
`mostRecentApprovalDate`	Dtestamp	`effective from` . هنگامی که یک برنامه نصب می شود، از تاریخ آخرین تغییر مهم قبل از نصب استفاده می شود.
`mostRecentApprovalDate`	خالی (یک مقدار خالی)	یا `userStatus` تحت نظارت است و هیچ تغییر قابل توجهی ارسال نشده است. یا `userStatus` تأیید شده، ناشناخته یا خالی است.
`installID`	شناسه الفبایی ایجاد شده توسط Play.	شناسه‌ای اختصاص داده شده به نصب‌های کاربر تحت نظارت توسط Google Play، که برای اطلاع شما از تأیید لغو لغو شده استفاده می‌شود. اسناد مربوط به تأییدیه‌های لغو شده برنامه را بررسی کنید.
`installID`	خالی (یک مقدار خالی)	`userStatus` تأیید شده، ناشناخته یا خالی است.

کدهای خطای API را مدیریت کنید

اگر برنامه شما یک درخواست Play Age Signals API (بتا) کند و تماس ناموفق باشد، برنامه شما یک کد خطا دریافت می‌کند. این خطاها ممکن است به دلایل مختلفی مانند قدیمی بودن برنامه Play Store رخ دهد.

استراتژی را دوباره امتحان کنید

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

مقدار عددی کد خطا	کد خطا	توضیحات	قابل امتحان مجدد
-1	API_NOT_AVAILABLE	Play Age Signals API در دسترس نیست. ممکن است نسخه برنامه Play Store نصب شده روی دستگاه قدیمی باشد. وضوح ممکن از کاربر بخواهید فروشگاه Play را به روز کند.	بله
-2	PLAY_STORE_NOT_FOUND	هیچ برنامه Play Store در دستگاه یافت نشد. از کاربر بخواهید Play Store را نصب یا فعال کند.	بله
-3	NETWORK_ERROR	هیچ شبکه موجودی یافت نشد. از کاربر بخواهید اتصال را بررسی کند.	بله
-4	PLAY_SERVICES_NOT_FOUND	Play Services در دسترس نیست یا نسخه آن خیلی قدیمی است. از کاربر بخواهید خدمات Play را نصب، به‌روزرسانی یا فعال کند.	بله
-5	CANNOT_BIND_TO_SERVICE	اتصال به سرویس در فروشگاه Play انجام نشد. این می تواند به دلیل نصب نسخه قدیمی Play Store روی دستگاه یا بارگیری بیش از حد حافظه دستگاه باشد. از کاربر بخواهید برنامه Play Store را به روز کند. با عقب نشینی نمایی دوباره تلاش کنید.	بله
-6	PLAY_STORE_VERSION_OUTDATED	برنامه Play Store باید به روز شود. از کاربر بخواهید برنامه Play Store را به روز کند.	بله
-7	PLAY_SERVICES_VERSION_OUTDATED	خدمات Play باید به روز شود. از کاربر بخواهید خدمات Play را به روز کند.	بله
-8	CLIENT_TRANSIENT_ERROR	یک خطای گذرا در دستگاه مشتری وجود دارد. یک استراتژی تلاش مجدد را با حداکثر تعداد تلاش به عنوان شرط خروج اجرا کنید. اگر مشکل همچنان حل نشد، از کاربر بخواهید بعداً دوباره امتحان کند.	بله
-9	APP_NOT_OWNED	برنامه توسط Google Play نصب نشده است. از کاربر بخواهید برنامه شما را از Google Play دریافت کند.	خیر
-100	INTERNAL_ERROR	خطای داخلی ناشناخته یک استراتژی تلاش مجدد را با حداکثر تعداد تلاش به عنوان شرط خروج اجرا کنید. اگر مشکل همچنان حل نشد، از کاربر بخواهید بعداً دوباره امتحان کند. اگر به طور مداوم با شکست مواجه شد، با پشتیبانی برنامه‌نویس Google Play تماس بگیرید ، API Age Signals را در موضوع قرار دهید، و تا حد امکان جزئیات فنی را درج کنید (مانند گزارش اشکال).	خیر

قبلی

نمای کلی

بعدی

تغییرات مهم را اطلاع دهید