В этом документе описаны ответы, которые возвращает 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.
Пример 2
Если пользователь указал, что он совершеннолетний, и разрешил делиться этой информацией с приложениями, вы получите следующие данные:
ageRangeSource:AgeRangeSource.TIER_A.ageLower– это число (например, 18).ageUpper:null.- Другие поля ответа:
null.
Пример 3
Если возраст контролируемого несовершеннолетнего пользователя указан законным представителем, который разрешил делиться этой информацией с приложениями, вы получите следующие данные:
ageRangeSource:AgeRangeSource.TIER_B.ageLower– это число (например, 13).ageUpper– это число (например, 15).- Другие поля ответа:
null.
Пример 4
Если пользователь (или его родитель) не дал согласия на передачу данных о возрасте, вы получите следующее:
ageRangeSource:null.ageLower:null.ageUpper:null.- Другие поля ответа:
null.
Пример 5
Если взрослый пользователь подтвердил свой возраст с помощью методов оценки возраста (например, селфи, кредитной карты или идентификационного номера налогоплательщика) и разрешил делиться этими данными с приложениями, вы получите следующее:
ageRangeSource:AgeRangeSource.TIER_C.ageLower– это число (например, 18).ageUpper:null.- Другие поля ответа:
null.
Пример 6
Для контролируемого несовершеннолетнего пользователя, возраст которого указан законным представителем, при одобренном значительном изменении и отслеживании числа активных установок вы получите следующее:
ageRangeSource:AgeRangeSource.TIER_B.ageLower– это число (например, 13).ageUpper– это число (например, 15).significantChangeStatus:SignificantChangeStatus.APPROVED.significantChangeApprovalDate– дата (например, "2026-01-15").installId– это строковый идентификатор (например, "abc123xyz789").