Используйте 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 SUPERVISED, VERIFIED, 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.
          }
        });

Данные о возрасте сохраняются Google Play на устройстве каждого пользователя. Когда пользователь с контролируемой учетной записью Google переходит в новый возрастной диапазон, Google Play автоматически обновляет кэшированные данные о возрасте для этого пользователя в течение 2–8 недель после дня рождения пользователя.

(Необязательно) Возможность выбора возрастных диапазонов

В соответствующих юрисдикциях и регионах 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 будет иметь значение AgeSignalsVerificationStatus.VERIFIED .
• Остальные поля ответа будут пустыми.

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

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

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

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

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

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

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

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