این سند پاسخهای نشان سن را که توسط Play Age Signals API برگردانده شده است توضیح میدهد.
(اختیاری) دریافت گروههای سنی سفارشی
گروههای سنی پیشفرضی که میانای برنامهسازی کاربردی برمیگرداند عبارتند از 0-12، 13-15،
16-17، و 18+.
یا برای سفارشیسازی کردن گروههای سنی پیشفرض براساس حداقل سنهای برنامهتان، میتوانید این حداقل سنها را برای برنامهتان در صفحه نشانههای سن در «کنسول Google Play» ارائه دهید.
- به صفحه نشانهای سن در «کنسول Play» بروید.
- در برگه گروههای سنی سفارشی، حداکثر سه حداقل سن برای برنامهتان وارد کنید. حداقل سنها باید حداقل ۲ سال باهم تفاوت داشته باشند و فقط یکبار در سال میتوان آنها را تغییر داد.
- روی ذخیره کلیک کنید.
گروههای سنی برگرداندهشده پاسخ پیشفرض میانای برنامهسازی کاربردی را لغو خواهد کرد. برای مثال:
- اگر یک حداقل سن (۱۵) در «کنسول 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 (نسخه بتا) شامل فیلدها و مقادیر زیر است. مسئولیت ارائه تجربههای مناسب سن کاربر بااستفاده از این نشانهها برعهده شما است.
| فیلد پاسخ | نوع | مقدار | شرح |
|---|---|---|---|
| ageRangeSource | شمارشی |
|
|
| ageLower | عدد صحیح |
|
کران پایین شامل محدوده سنی کاربر. آن را با ageUpper ترکیب کنید تا باند را تعیین کنید.
اگر ageSignalsStatus برابر با NOT_SHARED یا VERIFICATION_REQUIRED باشد، null برمیگرداند. |
| ageUpper | عدد صحیح |
|
کران بالای شامل محدوده سنی کاربر.
برای بالاترین محدوده (مثلاً ۱۸+) یا اگر ageSignalsStatus برابر با NOT_SHARED یا VERIFICATION_REQUIRED باشد، null برمیگرداند. |
| significantChangeStatus | شمارشی |
|
این فقط در حوزههای قضایی که تغییرات قابلتوجهی در آنها اعمال میشود، مقدار غیرتهی برمیگرداند.
|
| significantChangeApprovalDate | تاریخ |
|
تاریخ اعمال جدیدترین تغییر مهم تأییدشده. همه تغییرات با تاریخ اجرا قبلاز این تاریخ نیز تأیید میشوند. اگر تغییری وجود نداشته باشد، null را برمیگرداند.
آن را با `significantChangeStatus` ترکیب کنید تا وضعیت تأیید این تغییر قابلتوجه را دریافت کنید |
| installId | رشته |
|
شناسهای که Google Play به نصبهای کاربر تحت نظارت اختصاص میدهد و برای اطلاعرسانی به شما درباره تأییدیه باطلشده برنامه استفاده میشود. اسناد مربوط به تأییدیههای لغوشده برنامه را مرور کنید. |
مثال ۱
برای کاربر بزرگسالی که سن خود را بااستفاده از «شناسه دیجیتال» درستیسنجی کرده است، موارد زیر را دریافت میکنید:
در مناطق تحت نظارت قانون که درستیسنجی سن اجباری است:
ageRangeSourceAgeRangeSource.TIER_Dاست.ageLowerیک عدد است (برای مثال، ۱۸).ageUppernullاست.- فیلدهای پاسخ دیگر
nullاست.
هرجای دیگر:
ageRangeSourceAgeRangeSource.TIER_Aاست.ageLowerیک عدد است (برای مثال، ۱۸).ageUppernullاست.- فیلدهای پاسخ دیگر
nullاست.
مثال ۲
برای کاربر بزرگسالی که سن خود را بااستفاده از روشهای تخمین سن (مانند ارزیابی سلفی، کارت اعتباری، یا شناسه مالیاتی) درستیسنجی کرده است، موارد زیر را دریافت میکنید:
در مناطق تحت نظارت قانون که درستیسنجی سن اجباری است:
ageRangeSourceAgeRangeSource.TIER_Cاست.ageLowerیک عدد است (برای مثال، ۱۸).ageUppernullاست.- فیلدهای پاسخ دیگر
nullاست
هرجای دیگر:
ageRangeSourceAgeRangeSource.TIER_Aاست.ageLowerیک عدد است (برای مثال، ۱۸).ageUppernullاست.- فیلدهای پاسخ دیگر
nullاست.
مثال ۳
برای کاربری که در منطقهای ساکن است که درستیسنجی سن در آن اجباری نیست و آن را با برنامهها همرسانی میکند، موارد زیر را دریافت میکنید:
ageRangeSourceAgeRangeSource.TIER_Aاست.ageLowerیک عدد است (برای مثال، ۱۸).ageUppernullاست.- فیلدهای پاسخ دیگر
nullاست.
مثال ۴
برای کاربر صغیر تحت نظارتی که سن او توسط سرپرستی مدیریت میشود که آن را با برنامهها همرسانی کرده است، موارد زیر را دریافت میکنید:
ageRangeSourceAgeRangeSource.TIER_Bاست.ageLowerیک عدد است (برای مثال، ۱۳).ageUpperیک عدد است (برای مثال، ۱۵).- فیلدهای پاسخ دیگر
nullاست.
مثال ۵
برای کاربری که با همرسانی سن موافقت نکرده است (یا ولی او موافقت نکرده است) در منطقهای که درستیسنجی سن اجباری نیست، موارد زیر را دریافت میکنید:
ageRangeSourcenullاست.ageLowernullاست.ageUppernullاست.- فیلدهای پاسخ دیگر
nullاست.
نمونه ۶
برای کاربر خردسال تحت نظارت که سن او توسط ولی مدیریت میشود، با تغییر مهم تأییدشده و ردیابی نصب فعال، موارد زیر را دریافت میکنید:
ageRangeSourceAgeRangeSource.TIER_Bاست.ageLowerیک عدد است (برای مثال، ۱۳).ageUpperیک عدد است (برای مثال، ۱۵).significantChangeStatusSignificantChangeStatus.APPROVEDاست.-
significantChangeApprovalDateتاریخ است (برای مثال، «2026-01-15»). installIdشناسه رشته است (برای مثال، «abc123xyz789»).