Как использовать Play Age Signals API (бета)

// Create an instance of a manager
val ageSignalsManager =
    AgeSignalsManagerFactory.create(ApplicationProvider.getApplicationContext())

// Request an age signals check
ageSignalsManager
    .checkAgeSignals(AgeSignalsRequest.builder().build())
    .addOnSuccessListener { ageSignalsResult ->
        // Store the install ID for later...
        val installId = ageSignalsResult.installId()

        if (ageSignalsResult.userStatus() == AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_DENIED) {
          // Disallow access...
        } else {
           // Do something else if the user is VERIFIED, DECLARED, SUPERVISED, etc.
        }
    }

// 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 возвращает следующие возрастные диапазоны в соответствующих юрисдикциях и регионах: 0–12, 13–15, 16–17 и 18+.

Кроме того, чтобы настроить диапазоны возраста по умолчанию в соответствии с минимальным возрастом для вашего приложения, вы можете указать эти минимальные возрастные диапазоны для вашего приложения на странице Индикаторы возраста в Google Play Console.

1. Перейдите на страницу Сигналы о возрасте в Play Console.
2. На вкладке Специальные возрастные диапазоны укажите до трех возрастных ограничений для приложения. Разница между значениями должна составлять не менее двух лет. Менять возрастные ограничения можно раз в год.
3. Нажмите Сохранить.

Возрастные диапазоны, возвращаемые в ответе, переопределят ответ API по умолчанию. Пример:

• Если вы установите одно минимальное возрастное ограничение (15 лет) в Google Play Console:

  • Для ребенка от 0 до 14 лет будут возвращены значения ageLower = 0 и ageUpper = 14.
  • Для пользователя старше 15 лет будет возвращено значение ageLower = 15.

• Если вы установите два ограничения по возрасту (13 и 17 лет):

  • Для ребенка от 0 до 12 лет будут возвращены значения ageLower = 0 и ageUpper = 12.
  • Для пользователей от 13 до 16 лет будут возвращены значения ageLower = 13 и ageUpper = 16.
  • Для пользователей от 17 лет будет возвращено значение ageLower = 17.

• Если вы установите три ограничения по возрасту (11, 13 и 15 лет):

  • Для ребенка от 0 до 10 лет будут возвращены значения ageLower = 0 и ageUpper = 10.
  • Для 11- и 12-летних детей возвращаются значения ageLower = 11 и ageUpper = 12.
  • Для 13- и 14-летних пользователей возвращаются значения ageLower = 13 и ageUpper = 14.
  • Для пользователя старше 15 лет будет возвращено значение ageLower = 15.

Ответы на индикаторы возраста

Ответ Play Age Signals API (бета) включает следующие поля и значения. Значения могут меняться. Если вам нужны самые актуальные значения, запрашивайте ответ API при открытии приложения. Вы несете ответственность за предоставление подходящего по возрасту контента с использованием этих сигналов.

Примеры ответов о пользователях из Бразилии

В Бразилии userStatus может быть только DECLARED, UNKNOWN или null.

Если пользователь указал свой возраст и разрешил передавать его приложениям, вы получите следующие данные:

• userStatus будет стоить AgeSignalsVerificationStatus.DECLARED.
• ageLower – число (например, 13).
• ageUpper – число или null (например, 15).
• Другие поля ответа будут иметь значение null.

Если возраст пользователя неизвестен, вы получите следующий ответ:

• userStatus будет стоить AgeSignalsVerificationStatus.UNKNOWN.
• Другие поля ответа будут иметь значение null.

Если пользователь не разрешил передавать приложениям информацию о своем возрасте, вы получите следующие данные:

• userStatus будет стоить null.
• Другие поля ответа будут иметь значение null.

Когда возраст пользователя станет доступен для передачи, статус может измениться на DECLARED.

Примеры ответов для пользователей из штатов США

В штатах США, где действует закон, userStatus может быть VERIFIED, SUPERVISED, SUPERVISED_APPROVAL_PENDING, SUPERVISED_APPROVAL_DENIED, UNKNOWN или null.

Для подтвержденного пользователя вы получите следующее:

• userStatus будет стоить AgeSignalsVerificationStatus.VERIFIED.
• ageLower – число (например, 18).
• ageUpper – это число или null (например, null).
• Другие поля ответа будут иметь значение null.

Для контролируемого пользователя вы получите следующее:

• userStatus будет стоить AgeSignalsVerificationStatus.SUPERVISED.
• ageLower – число (например, 13).
• ageUpper – число или null (например, 15).
• mostRecentApprovalDate – объект даты Java (например, 2026-01-01) или null (если значительное изменение не было одобрено).
• installID – это буквенно-цифровой идентификатор, сгенерированный Google Play (например, 550e8400-e29b-41d4-a716-446655441111).

Если для контролируемого профиля ожидается одобрение важного изменения, вы получите следующий ответ:

• userStatus будет AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING.
• ageLower – число (например, 13).
• ageUpper – число или null (например, 15).
• mostRecentApprovalDate – объект даты Java (например, 2026-01-01) или null (если значительное изменение не было одобрено).
• installID – это буквенно-цифровой идентификатор, сгенерированный Google Play (например, 550e8400-e29b-41d4-a716-446655441111).

Обработка кодов ошибок API

Если приложение отправляет запрос с помощью Play Age Signals API, который не удается выполнить, возвращается код ошибки. Ошибки могут возникать по разным причинам, например из-за устаревшей версии приложения Google Play.

Стратегия повторных попыток

Если пользователь находится в сеансе, мы рекомендуем реализовать стратегию повторных попыток с максимальным количеством попыток в качестве условия выхода, чтобы ошибка как можно меньше мешала пользователю.