В этом документе описаны ответы, которые возвращает Play Age Signals API.
Как получать данные о возрастных диапазонах (необязательно)
По умолчанию API возвращает следующие возрастные диапазоны: 0-12, 13-15, 16-17 и 18+.
Вы также можете указать другие диапазоны с учетом возрастных ограничений для вашего приложения на странице Индикаторы возраста в Google Play Console.
- Перейдите на страницу Сигналы о возрасте в Play Console.
- На вкладке Собственные возрастные диапазоны укажите до трех возрастных ограничений для приложения. Разница между значениями должна составлять не менее двух лет. Менять возрастные ограничения можно раз в год.
- Нажмите Сохранить.
Возвращенные возрастные диапазоны переопределят ответ API по умолчанию. Пример:
- Если вы установили одно возрастное ограничение (15 лет) в Google Play Console:
- Для детей от 0 до 14 лет будут возвращены значения
ageLower = 0иageUpper = 14. - Для пользователей старше 15 лет будет возвращено значение
ageLower = 15.
- Для детей от 0 до 14 лет будут возвращены значения
- Если вы установите два минимальных возраста (13 и 17 лет):
- Для ребенка от 0 до 12 лет будут возвращены значения
ageLower = 0иageUpper = 12. - Для пользователей от 13 до 16 лет возвращаются значения
ageLower = 13иageUpper = 16. - Для пользователей от 17 лет будет возвращено значение
ageLower = 17.
- Для ребенка от 0 до 12 лет будут возвращены значения
- Если вы установите три минимальных возраста (11, 13 и 15 лет):
- Для ребенка от 0 до 10 лет будут возвращены значения
ageLower = 0иageUpper = 10. - Для 11- и 12-летних пользователей будут возвращены значения
ageLower = 11иageUpper = 12. - Для 13- и 14-летних пользователей будут возвращены значения
ageLower = 13иageUpper = 14. - Для пользователей старше 15 лет будет возвращено значение
ageLower = 15.
- Для ребенка от 0 до 10 лет будут возвращены значения
Поля ответов на сигналы возраста
Ответ Play Age Signals API (бета) включает следующие поля и значения. Вы несете ответственность за то, чтобы на основе этих сигналов предлагать пользователям подходящий по возрасту контент.
| Поле ответа | Тип | Значения | Описание |
|---|---|---|---|
| ageRangeSource | Перечисляемый тип |
|
|
| ageLower | Целое число |
|
Нижняя граница возрастного диапазона пользователя (включительно). Используется вместе с ageUpper для определения диапазона.
Возвращает null, если ageSignalsStatus имеет значение NOT_SHARED или VERIFICATION_REQUIRED. |
| ageUpper | Целое число |
|
Верхняя граница возрастного диапазона пользователя (включительно).
Возвращает null для самой высокой возрастной группы (например, 18+) или если ageSignalsStatus имеет значение NOT_SHARED или VERIFICATION_REQUIRED. |
| significantChangeStatus | Перечисляемый тип |
|
Ненулевое значение возвращается только в юрисдикциях, где применяются существенные изменения.
|
| significantChangeApprovalDate | Дата |
|
Дата вступления в силу последнего одобренного важного изменения. Все изменения с датами вступления в силу до этой даты также одобрены. Если изменений нет, возвращает null.
Используйте вместе с `significantChangeStatus`, чтобы получить статус рассмотрения для этого важного изменения. |
| installId | Строка |
|
Идентификатор, который Google Play присваивает установкам контролируемых пользователей. Он нужен, чтобы уведомлять вас об отзыве одобрения приложения. Ознакомьтесь с документацией по отмене одобрения приложений. |
Пример 1
Если совершеннолетний пользователь подтвердил возраст с помощью цифрового удостоверения личности, вы получите следующие данные:
В регионах, где проверка возраста обязательна:
ageRangeSource:AgeRangeSource.TIER_D.ageLower– это число (например, 18).ageUpper:null.- Другие поля ответа –
null.
Все остальные страны и регионы:
ageRangeSource:AgeRangeSource.TIER_A.ageLower– это число (например, 18).ageUpper:null.- Другие поля ответа –
null.
Пример 2
Если возраст взрослого пользователя подтвержден с помощью методов оценки возраста (например, селфи, кредитной карты или идентификационного номера налогоплательщика), вы получите следующие данные:
В регионах, где проверка возраста обязательна:
ageRangeSource:AgeRangeSource.TIER_C.ageLower– это число (например, 18).ageUpper:null.- Другие поля ответа:
null.
Все остальные страны и регионы:
ageRangeSource:AgeRangeSource.TIER_A.ageLower– это число (например, 18).ageUpper:null.- Другие поля ответа –
null.
Пример 3
Если пользователь находится в регионе, где подтверждение возраста не является обязательным, и делится этой информацией с приложениями, вы получите следующие данные:
ageRangeSource:AgeRangeSource.TIER_A.ageLower– это число (например, 18).ageUpper:null.- Другие поля ответа –
null.
Пример 4
Если родитель контролируемого несовершеннолетнего пользователя разрешил делиться его возрастом с приложениями, вы получите следующие данные:
ageRangeSource:AgeRangeSource.TIER_B.ageLower– это число (например, 13).ageUpper– это число (например, 15).- Другие поля ответа –
null.
Пример 5
Если пользователь (или его родитель) не дал согласие на передачу данных о возрасте в регионе, где проверка возраста не обязательна, вы получите следующее:
ageRangeSource:null.ageLower:null.ageUpper:null.- Другие поля ответа –
null.
Пример 6
Для контролируемого несовершеннолетнего пользователя, возраст которого указан опекуном, с одобренным значительным изменением и отслеживанием числа активных установок, вы получите следующие данные:
ageRangeSource:AgeRangeSource.TIER_B.ageLower– это число (например, 13).ageUpper– это число (например, 15).significantChangeStatus:SignificantChangeStatus.APPROVED.significantChangeApprovalDate– это дата (например, "2026-01-15").installId– это строковый идентификатор (например, "abc123xyz789").