Перейти к основному содержимому
Didit привлёк $7,5 млн на инфраструктуру для идентификации и борьбы с мошенничеством
Didit
В блог
Блог · 22 ноября 2026 г.

Интеграция Play Age Signals API: руководство по v0.0.6 для Android

Три вызова Play Age Signals 0.0.6 на Kotlin, таблица решений для всех статусов, уровней и границ, ошибки, миграция с 0.0.3 и 0.0.4, тестирование и запуск собственной проверки возраста.

Автор: DiditОбновлено
play-age-signals-api-integration-cover.png

Коротко

Чтобы интегрировать Play Age Signals API сегодня, добавьте com.google.android.play:age-signals:0.0.6, вызовите requestAgeSignalsAccess с Activity и вызывайте checkAgeSignals только тогда, когда статус равен SHARED.[1][2]

  • Считывайте возраст из ageLower. Уровень указывает, как был установлен возраст, а значение null никогда не означает совершеннолетнего.
  • Манифест библиотеки 0.0.6 объявляет minSdk 24, хотя в руководстве указан API 23.[1][11]
  • Сигнал остается в вашем приложении. Если вам требуется собственная проверка возраста, запускайте ее без сигнала.

Последняя проверка: 22 ноября 2026 · Не является юридической консультацией

Это техническое руководство по Play Age Signals API: сначала Android, затем Flutter, React Native, Expo и Unity. О том, кого это касается и что вступает в силу в январе 2027 года, читайте в статье Google Play Age Signals API: что изменится в январе 2027 года. Google предлагает API и не обязывает вызывать его; к этому может обязывать закон.

Каждый класс, метод и enum ниже были проверены по страницам Google и опубликованной библиотеке 0.0.6 по состоянию на 22 ноября 2026 года; код Kotlin для сигнала компилируется с ней.

Что вам понадобится

API работает на телефонах, складных устройствах и планшетах через приложение Play Store на устройстве.[1][5]

  • Установите minSdk на 24 (см. предупреждение).
  • Распространяйте через Google Play: условия ограничивают использование API приложениями, которые обновляются через Google Play.[5]
  • Откройте страницу Age signals в Play Console: там находятся пользовательские возрастные диапазоны, существенные изменения и отозванные одобрения.[3][8][9]
  • Заполните форму безопасности данных Play самостоятельно. Google заявляет, что клиентская библиотека не собирает данные, и решение по форме остается за вами.[5]

Обратите внимание

На странице настройки Google указан Android 6.0, уровень API 23.[1] Манифест внутри библиотеки 0.0.6 объявляет minSdkVersion 24; версии 0.0.3 и 0.0.4 объявляли 23.[11] Приложение с minSdk 23 может перестать собираться на этапе объединения манифестов после обновления. Простое решение: повысить его до 24.

  1. Февраль 20260.0.3Один вызов, userStatus, добавляет DECLARED.
  2. Июль 20260.0.4Два вызова, уровни заменяют userStatus.
  3. Ноябрь 20260.0.6Глобальный релиз, добавляет getApplicableAgeFeatures.
  4. 11 декабря 2026Все пользователиДата Google для возврата ответов всем пользователям.

Версии библиотеки на основе примечаний к выпуску и баннера Google.[2][4] До этой даты следует ожидать, что некоторые пользователи не будут получать ответ.

Добавьте библиотеку

Одна зависимость.[1] Тестовый fake-менеджер находится в том же артефакте.[11]

dependencies {
    implementation("com.google.android.play:age-signals:0.0.6")
}

1getApplicableAgeFeatures (необязательно)

Обязательна ли передача данных для этого пользователя.

2requestAgeSignalsAccess

Может показать собственный запрос от Google Play.

Статус равен SHARED

Да

3checkAgeSignals

Считывайте границы, источник и статус изменения.

Нет

Возраст от Google не получен

Используйте настройки по умолчанию, соответствующие возрасту.

Порядок вызовов в версии 0.0.6.[2]

Шаг 1: обязательна ли передача данных для этого пользователя

Этот вызов необязателен.[2] Метод features() содержит MANDATORY_SHARING только для пользователей из регионов, законы которых требуют от магазинов приложений передавать информацию о возрасте, и пуст для всех остальных.[2]

val manager = AgeSignalsManagerFactory.create(applicationContext)

manager.getApplicableAgeFeatures(ApplicableAgeFeaturesRequest.builder().build())
    .addOnSuccessListener { result ->
        val mandatory = ApplicableAgeFeature.MANDATORY_SHARING in result.features()
        // Use it to word your own screen. It is not an age.
    }
    .addOnFailureListener { error -> handleAgeSignalsError(error) }

Примечание

Обязательность означает, что передача данных обязательна для пользователя. Это ничего не говорит о том, как был установлен возраст: Google документирует MANDATORY_SHARING с TIER_A, TIER_B, TIER_C и TIER_D.[3]

Шаг 2: запросите доступ

В документации Google указано requestAgeSignalsAccess(Activity); метод принимает AgeSignalsAccessRequest, содержащий Activity.[2] Вызывайте его там, где допустим показ запроса пользователю.

val request = AgeSignalsAccessRequest.builder()
    .setActivity(this)
    .build()

manager.requestAgeSignalsAccess(request)
    .addOnSuccessListener { access ->
        when (access.ageSignalsStatus()) {
            AgeSignalsStatus.SHARED -> readSignals(manager)
            AgeSignalsStatus.NOT_SHARED -> applyGate(AgeGate.NoSignal)
            AgeSignalsStatus.VERIFICATION_REQUIRED -> applyGate(AgeGate.VerifyInPlay)
            else -> applyGate(AgeGate.NoSignal) // UNSPECIFIED or null
        }
    }
    .addOnFailureListener { error -> handleAgeSignalsError(error) }

То, что видит пользователь, зависит от региона и настроек:[2]

ПользовательЗапросСтатус
Штат США, где магазины обязаны передавать подтвержденный возраст; аккаунт подтвержден или под присмотромНетSHARED
То же самое, еще не подтвержденВ вашем приложении нет; Play обрабатывает это самVERIFICATION_REQUIRED
В других регионах: спрашивать перед передачей (настройка по умолчанию[14])Встроенный запрос от PlaySHARED или NOT_SHARED
В других регионах: всегда делитьсяНетSHARED
В других регионах: никогда не делитьсяНетNOT_SHARED
В других регионах: под родительским контролемНет; родитель решает в Family LinkSHARED или NOT_SHARED

После нескольких отклонений Play перестает показывать запрос, поэтому не вызывайте его в цикле.[2] Там, где передача обязательна, параметр зафиксирован на «Всегда делиться».[14]

Сопоставьте ваш возрастной экран с сигналом

Покажите нам ваш возрастной экран и ваши рынки, и мы покажем, для каких веток сценария нужна собственная проверка, а для каких нет.

Запросить демоНачать бесплатно

Шаг 3: прочитайте результат

Каждое поле может быть null, поэтому преобразуйте его один раз и используйте один тип в приложении. Это сопоставление считывает возраст только из границ диапазона.

sealed interface AgeGate {
    data object NoSignal : AgeGate
    data object VerifyInPlay : AgeGate
    data class Range(
        val lower: Int,
        val upper: Int?,         // null = top band, not "adult"
        val source: Int?,        // AgeRangeSource.TIER_A to TIER_D
        val changeStatus: Int?   // SignificantChangeStatus
    ) : AgeGate {
        fun isAtLeast(age: Int) = lower >= age
    }
}

fun toAgeGate(r: AgeSignalsResult): AgeGate {
    val lower: Int = r.ageLower() ?: return AgeGate.NoSignal
    return AgeGate.Range(
        lower, r.ageUpper(), r.ageRangeSource(), r.significantChangeStatus()
    )
}

private fun readSignals(manager: AgeSignalsManager) {
    manager.checkAgeSignals(AgeSignalsRequest.builder().build())
        .addOnSuccessListener { result -> applyGate(toAgeGate(result)) }
        .addOnFailureListener { error -> handleAgeSignalsError(error) }
}

Константы статуса, источника и изменений являются целыми числами, где 0 означает UNSPECIFIED.[10][11] Обработайте это в ветке else. Руководство Google 0.0.3 рекомендовало делать новый запрос при открытии приложения, поскольку значения меняются[12]; пользователь также может отключить передачу позже.[14]

Примечание

Это руководство также рекомендует параллельно вызывать Play Integrity API, чтобы запрос исходил из неизмененной сборки на сертифицированном устройстве.[12] Сигнал представляет собой ответ на стороне клиента: не доверяйте диапазону, который модифицированный клиент отправляет на ваш сервер.

Таблица решений: статус x источник x границы

Диапазоны по умолчанию: 0-12, 13-15, 16-17 и 18+.[3] Последний столбец содержит наши технические рекомендации, а не рекомендации Google.

СтатусИсточникНижняя / верхняяЧто это значитЧто делает ваш код
ИсключениенетнетНет ответа[7]Повторить, если ошибка допускает повтор, затем считать, что сигнала нет
NOT_SHAREDnullnull / nullПользователь или родитель не согласился на передачу данных[2][3]Настройки по умолчанию с учетом возраста, без повторного запроса
VERIFICATION_REQUIREDnullnull / nullНе подтверждено, в регионе, где проверка и передача данных обязательны[2][3]Перенаправьте в Play Store, сохраните значение по умолчанию
SHAREDTIER_A13 / 15Пользователь сообщил возраст Google, который мог подтвердить его или нет[3]Примените диапазон
SHAREDTIER_A18 / nullТо же самое, диапазон для совершеннолетних[3]Примените его; проводите дополнительную проверку, только если этого требует закон или уровень риска
SHAREDTIER_B13 / 15Возраст управляется родителем или опекуном[3]Примените диапазон, проверьте статус изменения
SHAREDTIER_C18 / nullОценено по банковской карте, email, селфи, государственному удостоверению личности или налоговому идентификатору[3]Примените диапазон
SHAREDTIER_D18 / nullГосударственное удостоверение личности с селфи или цифровое удостоверение личности[3]Примените диапазон
SHAREDлюбойnull / любойОтсутствует в таблице ответов GoogleСчитать отсутствием сигнала

Большинство ошибок вызывают три толкования:

  • TIER_A не означает «не проверено». Совершеннолетний пользователь, подтвердивший возраст через цифровое удостоверение личности, но передающий данные по собственному выбору, также возвращается как TIER_A.[3] TIER_C и TIER_D возвращаются только в регионах с обязательной проверкой возраста, например в Техасе.[3] В справочнике классов TIER_A обозначен как «заявленный самостоятельно», однако руководство по ответам сформулировано аккуратнее.[3][10]
  • TIER_B не является возрастом. Он указывает, кто управляет возрастом. Считывайте границы.
  • Границы со значением null не означают подтвержденного совершеннолетнего. Комментарий в примере кода Google на Java указывает на это, но пример на Kotlin говорит, что пользователь не передает данные, и таблица ответов согласуется с Kotlin.[2][3]

Когда следует остановиться

Если полученный диапазон отвечает на ваш вопрос, а закон или риски не требуют большего, остановитесь. Повторная проверка каждого пользователя трудносовместима с минимизацией данных, а в Калифорнии этот сигнал служит основным показателем, если только у вас нет убедительных внутренних данных.[15]

Если ветка сценария завершается отсутствием сигнала, логика дальнейших действий описана в материале что делать при NOT_SHARED, TIER_A или отсутствии ответа.

Нужен ответ, когда сигнал отсутствует

Запросите демо оценки возраста в вашем приложении: сначала селфи, документ только в пограничных случаях.

Запросить демоНачать бесплатно

Пользовательские минимальные возрасты

На вкладке Custom age ranges вы указываете до трех минимальных возрастов с разницей не менее двух лет, которые можно менять один раз в год. Они переопределяют стандартный ответ.[3]

Установленные минимальные возрастыВозвращаемые диапазоныВерхний диапазон
Нет (по умолчанию)0-12, 13-15, 16-17, 18+18 / null
150-14, 15+15 / null
13, 170-12, 13-16, 17+17 / null
11, 13, 150-10, 11-12, 13-14, 15+15 / null

Примеры из руководства по ответам Google.[3]

Пример

Вы задали 13 и 17. Для пользователя 25 лет теперь возвращается 17 / null, как и для пользователя 17 лет. Код, который считает null в ageUpper признаком совершеннолетия, пропустит 17-летних к функциям 18+. Поэтому сохраняйте 18 в списке, если ограничиваете доступ по возрасту 18 лет. Задокументированные границы заканчиваются на 18[3]: этот API не может обработать ограничение 21+.

Существенные изменения и отзыв одобрений

Обе функции предназначены для контролируемых пользователей. Решение о том, какой закон считает изменение существенным, принимаете вы, а не Play[8]; правила отдельных штатов приведены в статье App Store Accountability Acts.

Вы уведомляете Play

Существенное изменение

  • До 3 изменений, не более чем за 90 дней вперед, с интервалом более 2 дней
  • Требуется описание на английском языке, родителям оно показывается дословно
  • significantChangeStatus принимает значения APPROVED, PENDING или DECLINED
  • Ваше приложение должно ограничить измененную функцию

Накопительно: одно одобрение покрывает все ожидающие изменения[8]

Play уведомляет вас

Отозванное одобрение

  • installId уникален для пользователя и устройства и не сохраняется при сбросе настроек
  • Вы можете хранить его на своем сервере только для этой цели
  • Отозванные идентификаторы появляются в виде CSV в Play Console
  • Каждая запись удаляется через 90 дней, поэтому скачивайте их по графику

Один идентификатор может встречаться более одного раза[9]

Ограничивайте доступ к измененной функции, а не ко всему приложению, при статусах PENDING и DECLINED. Для аккаунтов без родительского контроля и для контролируемых аккаунтов без зафиксированных изменений статус равен null.[3]

Ошибки и неподдерживаемые устройства

Сбои возвращаются в виде AgeSignalsException. Google рекомендует выполнять повторные попытки с ограничением их максимального количества.[7]

// -8 (CLIENT_TRANSIENT_ERROR) to -1 (API_NOT_AVAILABLE) are marked retryable
private val RETRYABLE =
    AgeSignalsErrorCode.CLIENT_TRANSIENT_ERROR..AgeSignalsErrorCode.API_NOT_AVAILABLE
private var attempts = 0

fun handleAgeSignalsError(e: Exception) {
    val code = (e as? AgeSignalsException)?.errorCode
    if (code in RETRYABLE && attempts++ < 3) retryLater()
    else applyGate(AgeGate.NoSignal)
}
КодКонстантаПовторитьДействие
-1, -6API_NOT_AVAILABLE, PLAY_STORE_VERSION_OUTDATEDДаПопросить обновить Play Store
-2PLAY_STORE_NOT_FOUNDДаПопросить установить или включить Play Store
-3NETWORK_ERRORДаПопросить проверить подключение
-4, -7PLAY_SERVICES_NOT_FOUND, PLAY_SERVICES_VERSION_OUTDATEDДаПопросить установить, включить или обновить Play Services
-5CANNOT_BIND_TO_SERVICEДаЭкспоненциальная задержка, затем обновите Play Store
-8CLIENT_TRANSIENT_ERRORДаОграниченное число попыток, затем повторите позже
-9APP_NOT_OWNEDНетУстановлено не через Google Play: sideload или другой магазин
-10SDK_VERSION_OUTDATEDНетВключите более новую библиотеку
-11DEVICE_NOT_SUPPORTEDНетТип устройства не поддерживается; добавлено в 0.0.6[4]
-100INTERNAL_ERRORНетВ тексте Google по-прежнему предлагается ограничить число повторных попыток; приведенный выше код не повторяет запрос

Справочник кодов ошибок Google.[7] Ошибка не является возрастом: перейдите на сценарий по умолчанию.

Миграция с 0.0.3 и 0.0.4

Версия 0.0.3 все еще возвращает ответы, но больше не обновляется.[12] Переход с нее требует переписывания логики чтения; с 0.0.4 объем изменений невелик.

В вашем кодеВ 0.0.6С
Только checkAgeSignalsСначала requestAgeSignalsAccess[4]0.0.3
userStatus()Удалено: ageRangeSource() и significantChangeStatus()[4]0.0.3
VERIFIEDTIER_C или TIER_D (наша трактовка)0.0.3
DECLAREDTIER_A или TIER_B, если возрастом управляет родитель (наша трактовка)0.0.3
SUPERVISEDTIER_B (наша трактовка)0.0.3
SUPERVISED_APPROVAL_PENDING, SUPERVISED_APPROVAL_DENIEDTIER_B со значением PENDING или DECLINED (наша трактовка)0.0.3
UNKNOWN, nullСтатус доступа: VERIFICATION_REQUIRED или NOT_SHARED (наша трактовка)0.0.3
mostRecentApprovalDate()significantChangeApprovalDate()[4]0.0.3
Два вызова, уровниБез изменений; добавьте getApplicableAgeFeatures при необходимости[4]0.0.4
Обработка ошибокДобавьте DEVICE_NOT_SUPPORTED[4]Оба
minSdk 23Библиотека объявляет 24[11]Оба

Google не публикует прямого сопоставления значений. Строки с пометкой "наша трактовка" получены путем сравнения обоих определений.[3][12]

Обратите внимание

Старые константы AgeSignalsVerificationStatus по-прежнему входят в версию 0.0.6, поэтому импорты компилируются, хотя метод userStatus() отсутствует.[11] В 0.0.3 значение VERIFIED равнялось 0; в 0.0.6 значение 0 соответствует UNSPECIFIED.[10][11] Очищайте кэшированные целочисленные значения при обновлении.

Тестирование с FakeAgeSignalsManager и тестировщиками лицензий

Класс FakeAgeSignalsManager никогда не обращается к Play Store; документация ограничивает его использование модульными тестами и ранней разработкой.[32] Внедряйте менеджер так, чтобы его можно было заменить.

val fake = FakeAgeSignalsManager()

// Sharing is mandatory for this user
fake.setNextApplicableAgeFeaturesResult(
    ApplicableAgeFeaturesResult.builder()
        .setFeatures(setOf(ApplicableAgeFeature.MANDATORY_SHARING))
        .build()
)
// Verification still pending in Play
fake.setNextAgeSignalsAccessResult(
    AgeSignalsAccessResult.builder()
        .setAgeSignalsStatus(AgeSignalsStatus.VERIFICATION_REQUIRED)
        .build()
)
// Supervised 13 to 15, change waiting for the parent
fake.setNextAgeSignalsResult(
    AgeSignalsResult.builder()
        .setAgeRangeSource(AgeRangeSource.TIER_B)
        .setAgeLower(13)
        .setAgeUpper(15)
        .setSignificantChangeStatus(SignificantChangeStatus.PENDING)
        .setInstallId("fake_install_id_123")
        .build()
)
// Fails checkAgeSignals
fake.setNextAgeSignalsException(
    AgeSignalsException(AgeSignalsErrorCode.NETWORK_ERROR)
)
  • Покройте каждый статус, диапазон несовершеннолетних, диапазон взрослых, границы со значением null и по одной ошибке на вызов (методы setNextRequestAgeSignalsAccessException и setNextApplicableAgeFeaturesException вызывают сбой двух других).
  • Выполните реальный вызов с аккаунтом тестировщика лицензий: обычно приложение, обновленное не через Play, получает ошибку APP_NOT_OWNED; тестировщики могут установить отладочную сборку напрямую.[6]
  • Сохраняйте имя пакета идентичным приложению в Play и выполняйте вход с аккаунта тестировщика.[6]

Flutter, React Native, Expo и Unity

Это пакеты сообщества или сторонних фреймворков, а не Google, и их упоминание не является рекомендацией. Проверяйте версию библиотеки перед релизом.

СтекПакет проверенБиблиотекаЧто нужно знать до релиза
Expoexpo-age-range 58.0.30.0.4В вебе и на iOS до версии 26 возвращает lowerBound: 18, как для взрослого[17]
React Nativereact-native-play-age-range-declaration 3.0.50.0.4Также поддерживает другие магазины и Apple[19]
Flutterage_range_signals 0.10.10.0.4Схема с двумя вызовами, поддержка тестировщиков лицензий[18]
Unityunity-play-age-signals0.0.4Лицензия GPL-3.0; колбэки могут выполняться вне главного потока[20]

Данные получены 22 ноября 2026 со страницы каждого пакета или файла сборки.[17][18][19][20] Сотрудники Unity сообщили в декабре 2025, что компания не выпустит отдельный плагин.[21]

В пакете версии 0.0.4 нет getApplicableAgeFeatures и DEVICE_NOT_SUPPORTED. Если они нужны, напишите небольшой нативный мост. Сравнение с Apple приведено в материале Play Age Signals vs Apple Declared Age Range.

Не логируйте, не передавайте и не профилируйте

Условия Google разрешают использовать информацию только для адаптации контента по возрасту в соответствии с законами и только в запрашивающем приложении.[5] Правила запрещают рекламу, аналитику, профилирование, а также продажу, передачу или предоставление данных третьим лицам, за исключением случаев, когда этого строго требует закон.[13]

  • Не сохраняйте диапазоны, уровни и installId в логи, отчеты об ошибках и события аналитики: эти инструменты обычно принадлежат третьим лицам.
  • По возможности храните исходный результат в оперативной памяти и сохраняйте решение о доступности функции, а не сам уровень.
  • Никогда не передавайте сигнал поставщику проверки возраста, включая Didit.
  • В Калифорнии не предлагайте пользователям изменить данные о возрасте и не передавайте сигнал третьим лицам в целях, не предусмотренных законом.[15]
  • Проконсультируйтесь с юристом перед запросом сигнала для каждого пользователя: закон Калифорнии запрещает запросы, не требуемые им или другим применимым законом.[15]

Поэтому сообщение с просьбой перейти в Play Store предназначено для VERIFICATION_REQUIRED, а не для пользователя из Калифорнии, в чьем возрастном диапазоне вы сомневаетесь. На региональной странице Google указано, что требования станут обязательными в Калифорнии и Бразилии с января 2027 года, а для Алабамы указан статус «Подробности появятся позже».[16] Обязанности по законодательству Калифорнии описаны в руководстве по Digital Age Assurance Act.

После сигнала: запустите собственную проверку

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

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "YOUR_AGE_WORKFLOW_ID",
    "vendor_data": "user-42"
  }'

Ответ 201 содержит session_id, session_token и url.[25] Отправьте в приложение только токен, затем запустите SDK:[26]

// Once, in Application.onCreate: DiditSdk.initialize(this)

lifecycleScope.launch {
    DiditSdk.state.collect { state ->
        if (state is DiditSdkState.Ready) DiditSdk.launchVerificationUI(this@MainActivity)
    }
}

DiditSdk.startVerification(token = sessionToken) { result ->
    when (result) {
        is VerificationResult.Completed -> refreshAgeDecision() // asks your server
        is VerificationResult.Cancelled -> keepSafeDefault()
        is VerificationResult.Failed -> keepSafeDefault()
    }
}

Результат SDK служит для интерфейса. Принимайте решение на основе подписанного вебхука status.updated или вызывайте GET /v3/session/{sessionId}/decision/ со своего сервера.[25][29] При отмене или сбое используйте безопасное значение по умолчанию.

Учитывайте ограничения

Если сигнала достаточно, пропустите этот шаг. Собственная проверка не всегда имеет приоритет. Законы Алабамы и Юты с требованиями с 2027 используют самую младшую возрастную категорию для мер защиты, а в Бразилии действует правило максимальной защиты, поэтому проверка там может только ужесточить условия.[22][23][24] Пользователям, подпадающим под законы Иллинойса, Техаса или Колорадо, перед селфи требуется шаг согласия на обработку биометрии, который умеет отображать нативный SDK 4.10.0 или новее.[28] Уточните у юриста, какие правила применимы к вашему приложению.

Как Didit помогает после получения сигнала

Didit Age Estimation оценивает возраст по селфи с проверкой liveness на том же шаге и не раскрывает личность пользователя. Сценарий может направлять пограничный диапазон, заданный вами, на проверку документов.[27] Age Estimation стоит $0.10 за запрос; см. цены.

Didit console, age estimation result of a verification: the estimated age from the selfie next to the age on the document

Результат оценки возраста в консоли Didit (пример данных): оценка по селфи рядом с возрастом по документу.

Доступны нативные SDK для Android, iOS, React Native и Flutter. Для Unity и других движков документированным вариантом является интеграция через WebView.[31] Каналы за пределами Google Play описаны в статье Age verification API: приложения, веб и магазины и на странице решения для проверки возраста.

Didit предоставляет

  • Хостинговую проверку возраста с селфи, liveness и опциональным шагом проверки документов
  • Вариант сценария по стандарту ISO/IEC 27566-1, который возвращает решение «да» или «нет» о возрасте без персональных данных, начиная с минимального возраста 13 лет[27]
  • Сроки хранения данных, переключатели возвращаемых данных и вызов API для удаления[30]

Остается на вашей стороне

  • Вызов Play Age Signals и его результат
  • Применимый закон и необходимость проверки как таковой
  • Настройки по умолчанию с учетом возраста и окончательное решение о доступе

У Didit нет коннектора к Play Age Signals: сигнал остается в вашем приложении.

Посмотрите, как резервная ветка работает в вашем приложении

Приходите со своим возрастным экраном, рынками и стеком или настройте сценарий самостоятельно.

Запросить демоНачать бесплатноЧитать документацию

Ключевые выводы

  • Используйте версию 0.0.6: опциональный вызов проверки функций, запрос доступа, затем checkAgeSignals только при значении SHARED.
  • Ограничивайте доступ по ageLower; значение null в ageUpper означает верхний диапазон, а настраиваемые возрасты могут сдвинуть его ниже 18.
  • Значения null в границах, UNSPECIFIED и ошибки означают отсутствие сигнала, но никогда не означают взрослого пользователя.
  • Манифест версии 0.0.6 объявляет minSdk 24.
  • Храните сигнал в своем приложении и запускайте любую собственную проверку без него.

Часто задаваемые вопросы

Какую версию Play Age Signals API следует использовать?

Используйте 0.0.6. Это текущая версия, доступная глобально, и Google заявляет, что она будет возвращать ответы для всех пользователей к 11 декабря 2026 года; тем временем 0.0.4 продолжает возвращать ответы в отдельных регионах.[2]

Нужно ли вызывать getApplicableAgeFeatures?

Нет, Google указывает этот метод как необязательный. Вызывайте его, когда ваши собственные экраны должны отличаться для пользователя, передача данных которого обязательна.[2]

В чем разница между NOT_SHARED и VERIFICATION_REQUIRED?

NOT_SHARED означает, что приложение не получает сигнал возраста, так как пользователь или родитель не согласились на передачу данных. VERIFICATION_REQUIRED означает, что возраст не подтвержден в регионе, где проверка и передача данных обязательны, и Google рекомендует попросить пользователя перейти в Play Store.[2]

Почему обе границы равны null?

Справочник по ответу возвращает границы null, когда статус равен NOT_SHARED или VERIFICATION_REQUIRED.[3] Считайте границы null отсутствием сигнала и никогда не считайте их взрослым пользователем.

Почему ageUpper равен null для взрослых?

Потому что верхний диапазон открыт: для 18+ возвращаются ageLower 18 и ageUpper null.[3] При настраиваемых возрастах верхний диапазон может начинаться ниже, поэтому сравнивайте ageLower со своим минимальным возрастом.

Могу ли я настроить собственные возрастные диапазоны?

Да, до трех минимальных возрастов на странице Age signals в Play Console с разницей не менее двух лет, с возможностью изменения раз в год. Они переопределяют диапазоны по умолчанию.[3]

Как проводить тестирование до того, как закон вступит в силу?

Используйте FakeAgeSignalsManager для возврата любого статуса, диапазона или ошибки, включая MANDATORY_SHARING. Аккаунт тестировщика лицензий позволяет отладочной сборке, установленной напрямую, вызывать работающий API.[6]

Работает ли это в Trusted Web Activity или WebView?

Не из веб-кода. Это библиотека Android, вызываемая с Activity, и изученные нами страницы Google не документируют веб-интерфейс. Приложению-обертке потребуется собственный нативный код, а условия Google ограничивают предоставление информации только запрашивающим приложением.[2][5]

Существует ли плагин для Unity, Flutter или React Native?

Существуют пакеты от сообщества и разработчиков фреймворков. Пакеты, которые мы проверили 22 ноября 2026 года, заявляют версию 0.0.4, поэтому в них нет getApplicableAgeFeatures. Представители Unity сообщили в декабре 2025 года, что Unity не будет выпускать отдельный плагин.[17][18][19][20][21]

Могу ли я сохранять результат на своем сервере?

Страницы Google прямо описывают сохранение installId на вашем сервере для уведомлений об отзыве. В остальном храните минимальный объем данных, необходимый для выполнения юридических обязательств, внутри собственных систем и никогда не передавайте его в аналитику, рекламу или сторонние сервисы, если только закон строго не требует этого.[9][13]

Источники

  1. Использование Play Age Signals API (бета), Android Developers, обновлено 19 ноября 2026 года.
  2. Запрос сигналов возраста, Android Developers, обновлено 18 ноября 2026 года.
  3. Понимание ответов с сигналами возраста, Android Developers, обновлено 18 ноября 2026 года.
  4. Примечания к выпуску Play Age Signals, Android Developers, обновлено 19 ноября 2026 года.
  5. Обзор и условия использования Play Age Signals, Android Developers, обновлено 18 ноября 2026 года.
  6. Тестирование интеграции с Play Age Signals API (бета), Android Developers, обновлено 19 ноября 2026 года.
  7. Справочник по кодам ошибок Play Age Signals API, Android Developers, обновлено 18 ноября 2026 года.
  8. Уведомление Google Play о существенных изменениях, Android Developers, обновлено 4 сентября 2026 года.
  9. Просмотр отозванных разрешений для приложений, Android Developers, обновлено 4 сентября 2026 года.
  10. Справочник по AgeRangeSource, Android Developers, обновлено 18 ноября 2026 года.
  11. com.google.android.play:age-signals, Google Maven; манифесты и классы библиотеки версий 0.0.3, 0.0.4 и 0.0.6 изучены 22 ноября 2026 года.
  12. Использование Play Age Signals API, версия 0.0.3, Android Developers, обновлено 23 октября 2026 года.
  13. Политика в отношении Age Signals API и пользовательских данных, Справка Google Play Console.
  14. О передаче возрастного диапазона в Google Play, Справка Google Play.
  15. AB 1856, Chapter 184, Statutes of 2026, California Legislative Information; вносит изменения в Civil Code с 1798.500 по 1798.504.
  16. Региональные меры защиты по возрасту в Play, Android Developers, обновлено 18 ноября 2026 года.
  17. Expo AgeRange, документация Expo; пакет expo-age-range 58.0.3.
  18. age_range_signals, pub.dev, версия 0.10.1 от 6 октября 2026.
  19. react-native-play-age-range-declaration, GitHub, версия 3.0.5.
  20. unity-play-age-signals, GitHub, обновлено 4 августа 2026.
  21. Play Age Signals API Support, Unity Discussions, ответ команды Unity от декабря 2025.
  22. Code of Alabama 8-19K-9 (HB 161), легислатура Алабамы.
  23. Utah Code 13-76-202, легислатура Юты; обязанности разработчиков с 6 мая 2027.
  24. Decreto 12.880 от 18 марта 2026, ст. 25, Planalto, Бразилия.
  25. Create session, документация Didit.
  26. Android SDK, документация Didit.
  27. Age Estimation overview, документация Didit.
  28. Biometric consent, документация Didit.
  29. Webhooks, документация Didit.
  30. Data retention, документация Didit.
  31. Native SDKs overview, документация Didit.
  32. FakeAgeSignalsManager reference, Android Developers, обновлено 18 ноября 2026.

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

Добавьте проверку для пользователей без сигнала

Запросите демо оценки возраста в вашем приложении или создайте сценарий и запустите сессию уже сегодня.

Запросить демоНачать бесплатно

Инфраструктура для идентификации и борьбы с мошенничеством.

Единый API для KYC, KYB, мониторинга транзакций и проверки кошельков. Интеграция за 5 минут.

Попросите ИИ кратко изложить эту страницу