Используйте API сигналов Play Age (бета)

// 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. Возвращаемые возрастные диапазоны будут переопределять ответ API по умолчанию. Например, если вы укажете минимальный возраст 9, 15 и 17 лет, 14-летний пользователь попадет в возрастной диапазон 10-15 лет.

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

1. Перейдите на страницу «Возрастные сигналы» в вашей игровой консоли.
2. На вкладке «Настраиваемые возрастные диапазоны» введите до трех минимальных возрастных категорий для вашего приложения. Разница между минимальными возрастными категориями должна составлять не менее 2 лет, и их можно изменять один раз в год.
3. Нажмите « Сохранить ».

Возраст сигнализирует о реакции

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

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

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

Пользователю, указавшем свой возраст, будет предоставлена ​​следующая информация:

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

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

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

Статус пользователя может измениться с UNKNOWN на 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 Date (например, 2026-01-01 ) или null (если существенных изменений не было утверждено).
• installID это сгенерированный Play идентификатор, состоящий из букв и цифр (например, 550e8400-e29b-41d4-a716-446655441111 ).

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

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

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

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

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

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