با استفاده از API سیگنال‌های سن بازی (بتا)، شما با شرایط خدمات موافقت می‌کنید و موافقت می‌کنید که از تمام سیاست‌های توسعه‌دهندگان Google Play پیروی کنید. برای درخواست وضعیت و محدوده سنی کاربر، API را در زمان اجرا از برنامه خود فراخوانی می‌کنید. API سیگنال‌های سن بازی فقط داده‌های مربوط به کاربران مستقر در مناطقی را که Play طبق قانون موظف به ارائه داده‌های رده سنی است، برمی‌گرداند.
Play یک محدوده سنی را بر اساس گروه‌های سنی تعریف‌شده توسط حوزه قضایی و مناطق مربوطه برمی‌گرداند. سنین پیش‌فرضی که API در حوزه‌های قضایی و مناطق مربوطه برمی‌گرداند، 0-12، 13-15، 16-17 و 18+ سال هستند، اما این موارد ممکن است بر اساس الزامات منطقه‌ای تغییر کنند.
API سیگنال‌های سن بازی را در برنامه خود ادغام کنید
برای ادغام 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.
}
});
سیگنال‌های سنی توسط گوگل پلی برای هر کاربر در دستگاه ذخیره می‌شوند. وقتی کاربری با حساب گوگل تحت نظارت وارد محدوده سنی جدیدی می‌شود، گوگل پلی به طور خودکار سیگنال‌های سنی ذخیره شده برای آن کاربر را ظرف ۲ تا ۸ هفته پس از تولد کاربر به‌روزرسانی می‌کند.
(اختیاری) دریافت محدوده‌های سنی سفارشی
محدوده‌های سنی پیش‌فرض که API در حوزه‌های قضایی و مناطق مربوطه برمی‌گرداند، ۰-۱۲، ۱۳-۱۵، ۱۶-۱۷ و ۱۸+ سال است. این محدوده‌ها ممکن است در آینده بر اساس الزامات محلی تغییر کنند.
روش دیگر، برای سفارشی‌سازی محدوده‌های سنی با توجه به حداقل سن برنامه‌تان، می‌توانید این حداقل سن‌ها را برای برنامه‌تان در صفحه Age signals در کنسول گوگل پلی خود ارائه دهید. API Age Signals محدوده‌های سنی سفارشی‌شده را برمی‌گرداند. برای مثال، اگر حداقل سن ۹، ۱۵ و ۱۷ سال را ارائه دهید، یک کاربر ۱۴ ساله در محدوده سنی ۱۰ تا ۱۵ سال قرار می‌گیرد. حداقل سن‌ها باید حداقل ۲ سال با هم فاصله داشته باشند و می‌توانند سالی یک بار تغییر کنند.
برای سفارشی‌سازی محدوده‌های سنی که توسط API سیگنال‌های سن برگردانده می‌شوند، می‌توانید حداقل سن را برای برنامه خود ارائه دهید:
- به صفحه سیگنال‌های سنی در کنسول Play خود بروید.
- در برگه حداقل سن برنامه ، حداکثر سه سن حداقل برای برنامه خود وارد کنید.
- روی ذخیره کلیک کنید.
پاسخ‌های سیگنال‌های سنی
پاسخ API سیگنال‌های سن بازی (بتا) شامل فیلدها و مقادیر زیر است. مقادیر ممکن است تغییر کنند. اگر جدیدترین مقادیر را می‌خواهید، هنگام باز شدن برنامه خود، پاسخ API را درخواست کنید. شما مسئول ارائه تجربیات متناسب با سن با استفاده از این سیگنال‌ها هستید.
| فیلد پاسخ | ارزش‌ها | توضیحات |
|---|---|---|
userStatus | تأیید شده | کاربر بالای ۱۸ سال سن دارد. گوگل سن کاربر را با استفاده از یک روش تجاری معقول مانند کارت شناسایی دولتی، کارت اعتباری یا تخمین سن از طریق چهره تأیید کرده است. |
| تحت نظارت | کاربر یک حساب گوگل تحت نظارت دارد که توسط یکی از والدینش که سن او را تنظیم می‌کند، مدیریت می‌شود. از ageLower و ageUpper برای تعیین محدوده سنی کاربر استفاده کنید. | |
| تایید تحت نظارت در انتظار | کاربر یک حساب گوگل تحت نظارت دارد و والد ناظر او هنوز یک یا چند تغییر مهم در حال بررسی را تأیید نکرده است. از ageLower و ageUpper برای تعیین محدوده سنی کاربر استفاده کنید. از mostRecentApprovalDate برای تعیین آخرین تغییر مهمی که تأیید شده است استفاده کنید. | |
| تایید_نظارت_شده_رد_شده | کاربر یک حساب گوگل تحت نظارت دارد و والد ناظر او، تأیید یک یا چند تغییر مهم را رد کرده است. از ageLower و ageUpper برای تعیین محدوده سنی کاربر استفاده کنید. از mostRecentApprovalDate برای تعیین آخرین تغییر مهمی که تأیید شده است استفاده کنید. | |
| ناشناخته | کاربر در حوزه‌های قضایی و مناطق مربوطه تأیید یا نظارت نمی‌شود. این کاربران می‌توانند بالای ۱۸ سال یا زیر ۱۸ سال سن داشته باشند. برای دریافت سیگنال سن از گوگل پلی، از کاربر بخواهید برای حل وضعیت خود به فروشگاه پلی مراجعه کند. | |
| خالی (یک مقدار خالی) | همه کاربران دیگر این مقدار را برمی‌گردانند. | |
ageLower | ۰ تا ۱۸ | حد پایین (شامل) محدوده سنی کاربر تحت نظارت. از ageLower و ageUpper برای تعیین محدوده سنی کاربر استفاده کنید. |
| خالی (یک مقدار خالی) | userStatus نامشخص یا خالی است. | |
ageUpper | ۲ تا ۱۸ | حد بالای (شامل) محدوده سنی کاربر تحت نظارت. از ageLower و ageUpper برای تعیین محدوده سنی کاربر استفاده کنید. |
| خالی (یک مقدار خالی) | یا userStatus تحت نظارت است و سن تأیید شده والدین کاربر بالای ۱۸ سال است. یا userStatus تأیید شده، ناشناخته یا خالی است. | |
mostRecentApprovalDate | مهر تاریخ | تاریخ effective from آخرین تغییر مهمی که تأیید شده است. هنگام نصب یک برنامه، تاریخ آخرین تغییر مهم قبل از نصب استفاده می‌شود. |
| خالی (یک مقدار خالی) | یا userStatus تحت نظارت است و هیچ تغییر قابل توجهی ارسال نشده است. یا userStatus تأیید شده، ناشناخته یا خالی است. | |
installID | شناسه الفبایی عددی تولید شده توسط بازی. | شناسه‌ای که توسط گوگل پلی به نصب‌های تحت نظارت کاربران اختصاص داده شده و برای اطلاع‌رسانی در مورد لغو تأیید برنامه استفاده می‌شود. مستندات مربوط به لغو تأیید برنامه‌ها را بررسی کنید. |
| خالی (یک مقدار خالی) | userStatus تأیید شده، ناشناخته یا خالی است. |
مدیریت کدهای خطای API
اگر برنامه شما درخواست Play Age Signals API (بتا) را ارسال کند و فراخوانی ناموفق باشد، برنامه شما یک کد خطا دریافت می‌کند. این خطاها می‌توانند به دلایل مختلفی مانند قدیمی بودن برنامه Play Store رخ دهند.
استراتژی تلاش مجدد
در شرایطی که کاربر در حال استفاده از جلسه است، توصیه می‌کنیم یک استراتژی تلاش مجدد با حداکثر تعداد تلاش به عنوان شرط خروج پیاده‌سازی کنید تا خطا تا حد امکان تجربه کاربر را مختل نکند.
| مقدار عددی کد خطا | کد خطا | توضیحات | قابل امتحان مجدد |
|---|---|---|---|
| -1 | API_NOT_AVAILABLE | رابط برنامه‌نویسی کاربردی سیگنال‌های سن بازی (Play Age Signals API) در دسترس نیست. نسخه برنامه فروشگاه پلی که روی دستگاه نصب شده است ممکن است قدیمی باشد. قطعنامه احتمالی
| بله |
| -۲ | فروشگاه_بازیافت_نشد | هیچ برنامه‌ای از فروشگاه Play روی دستگاه یافت نمی‌شود. از کاربر بخواهید که Play Store را نصب یا فعال کند. | بله |
| -3 | خطای شبکه | هیچ شبکه‌ای یافت نشد. از کاربر بخواهید که اتصال را بررسی کند. | بله |
| -4 | خدمات_بازی_یافت_نشد | خدمات Play در دسترس نیست یا نسخه آن خیلی قدیمی است. از کاربر بخواهید خدمات Play را نصب، به‌روزرسانی یا فعال کند. | بله |
| -5 | نمی‌توان به سرویس متصل شد | اتصال به سرویس در فروشگاه Play ناموفق بود. این می‌تواند به دلیل نصب نسخه قدیمی فروشگاه Play روی دستگاه یا پر بودن بیش از حد حافظه دستگاه باشد. از کاربر بخواهید برنامه فروشگاه Play را به‌روزرسانی کند. با یک backoff نمایی دوباره امتحان کنید. | بله |
| -6 | نسخه_فروشگاه_بازی_خارج_از_تاریخ | برنامه‌ی Play Store نیاز به به‌روزرسانی دارد. از کاربر بخواهید که برنامه‌ی Play Store را به‌روزرسانی کند. | بله |
| -7 | نسخه_خدمات_بازی_خارج_از_تاریخ | سرویس‌های Play نیاز به به‌روزرسانی دارند. از کاربر بخواهید که سرویس‌های Play را به‌روزرسانی کند. | بله |
| -8 | خطای گذرای کلاینت | یک خطای گذرا در دستگاه کلاینت رخ داده است. یک استراتژی تلاش مجدد با حداکثر تعداد تلاش به عنوان شرط خروج پیاده‌سازی کنید. اگر مشکل هنوز حل نشده است، از کاربر بخواهید بعداً دوباره امتحان کند. | بله |
| -9 | APP_NOT_OWNED | برنامه توسط گوگل پلی نصب نشده است. از کاربر بخواهید برنامه شما را از گوگل پلی دریافت کند. | خیر |
| -100 | خطای داخلی | خطای داخلی ناشناخته. یک استراتژی تلاش مجدد با حداکثر تعداد تلاش به عنوان شرط خروج پیاده‌سازی کنید. اگر مشکل هنوز حل نشده است، از کاربر بخواهید بعداً دوباره امتحان کند. اگر مرتباً ناموفق بود، با پشتیبانی توسعه‌دهندگان Google Play تماس بگیرید ، عبارت Play Age Signals API را در موضوع وارد کنید و تا حد امکان جزئیات فنی (مانند گزارش اشکال) را نیز ذکر کنید. | خیر |