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

Коротко
Чтобы интегрировать 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]
- Сигнал остается в вашем приложении. Если вам требуется собственная проверка возраста, запускайте ее без сигнала.
Это техническое руководство по 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.
- Февраль 20260.0.3Один вызов,
userStatus, добавляет DECLARED. - Июль 20260.0.4Два вызова, уровни заменяют
userStatus. - Ноябрь 20260.0.6Глобальный релиз, добавляет
getApplicableAgeFeatures. - 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]) | Встроенный запрос от Play | SHARED или NOT_SHARED |
| В других регионах: всегда делиться | Нет | SHARED |
| В других регионах: никогда не делиться | Нет | NOT_SHARED |
| В других регионах: под родительским контролем | Нет; родитель решает в Family Link | SHARED или 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_SHARED | null | null / null | Пользователь или родитель не согласился на передачу данных[2][3] | Настройки по умолчанию с учетом возраста, без повторного запроса |
VERIFICATION_REQUIRED | null | null / null | Не подтверждено, в регионе, где проверка и передача данных обязательны[2][3] | Перенаправьте в Play Store, сохраните значение по умолчанию |
SHARED | TIER_A | 13 / 15 | Пользователь сообщил возраст Google, который мог подтвердить его или нет[3] | Примените диапазон |
SHARED | TIER_A | 18 / null | То же самое, диапазон для совершеннолетних[3] | Примените его; проводите дополнительную проверку, только если этого требует закон или уровень риска |
SHARED | TIER_B | 13 / 15 | Возраст управляется родителем или опекуном[3] | Примените диапазон, проверьте статус изменения |
SHARED | TIER_C | 18 / null | Оценено по банковской карте, email, селфи, государственному удостоверению личности или налоговому идентификатору[3] | Примените диапазон |
SHARED | TIER_D | 18 / 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 |
| 15 | 0-14, 15+ | 15 / null |
| 13, 17 | 0-12, 13-16, 17+ | 17 / null |
| 11, 13, 15 | 0-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, -6 | API_NOT_AVAILABLE, PLAY_STORE_VERSION_OUTDATED | Да | Попросить обновить Play Store |
| -2 | PLAY_STORE_NOT_FOUND | Да | Попросить установить или включить Play Store |
| -3 | NETWORK_ERROR | Да | Попросить проверить подключение |
| -4, -7 | PLAY_SERVICES_NOT_FOUND, PLAY_SERVICES_VERSION_OUTDATED | Да | Попросить установить, включить или обновить Play Services |
| -5 | CANNOT_BIND_TO_SERVICE | Да | Экспоненциальная задержка, затем обновите Play Store |
| -8 | CLIENT_TRANSIENT_ERROR | Да | Ограниченное число попыток, затем повторите позже |
| -9 | APP_NOT_OWNED | Нет | Установлено не через Google Play: sideload или другой магазин |
| -10 | SDK_VERSION_OUTDATED | Нет | Включите более новую библиотеку |
| -11 | DEVICE_NOT_SUPPORTED | Нет | Тип устройства не поддерживается; добавлено в 0.0.6[4] |
| -100 | INTERNAL_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 |
VERIFIED | TIER_C или TIER_D (наша трактовка) | 0.0.3 |
DECLARED | TIER_A или TIER_B, если возрастом управляет родитель (наша трактовка) | 0.0.3 |
SUPERVISED | TIER_B (наша трактовка) | 0.0.3 |
SUPERVISED_APPROVAL_PENDING, SUPERVISED_APPROVAL_DENIED | TIER_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, и их упоминание не является рекомендацией. Проверяйте версию библиотеки перед релизом.
| Стек | Пакет проверен | Библиотека | Что нужно знать до релиза |
|---|---|---|---|
| Expo | expo-age-range 58.0.3 | 0.0.4 | В вебе и на iOS до версии 26 возвращает lowerBound: 18, как для взрослого[17] |
| React Native | react-native-play-age-range-declaration 3.0.5 | 0.0.4 | Также поддерживает другие магазины и Apple[19] |
| Flutter | age_range_signals 0.10.1 | 0.0.4 | Схема с двумя вызовами, поддержка тестировщиков лицензий[18] |
| Unity | unity-play-age-signals | 0.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 (пример данных): оценка по селфи рядом с возрастом по документу.
Доступны нативные 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]
Источники
- Использование Play Age Signals API (бета), Android Developers, обновлено 19 ноября 2026 года.
- Запрос сигналов возраста, Android Developers, обновлено 18 ноября 2026 года.
- Понимание ответов с сигналами возраста, Android Developers, обновлено 18 ноября 2026 года.
- Примечания к выпуску Play Age Signals, Android Developers, обновлено 19 ноября 2026 года.
- Обзор и условия использования Play Age Signals, Android Developers, обновлено 18 ноября 2026 года.
- Тестирование интеграции с Play Age Signals API (бета), Android Developers, обновлено 19 ноября 2026 года.
- Справочник по кодам ошибок Play Age Signals API, Android Developers, обновлено 18 ноября 2026 года.
- Уведомление Google Play о существенных изменениях, Android Developers, обновлено 4 сентября 2026 года.
- Просмотр отозванных разрешений для приложений, Android Developers, обновлено 4 сентября 2026 года.
- Справочник по AgeRangeSource, Android Developers, обновлено 18 ноября 2026 года.
- com.google.android.play:age-signals, Google Maven; манифесты и классы библиотеки версий 0.0.3, 0.0.4 и 0.0.6 изучены 22 ноября 2026 года.
- Использование Play Age Signals API, версия 0.0.3, Android Developers, обновлено 23 октября 2026 года.
- Политика в отношении Age Signals API и пользовательских данных, Справка Google Play Console.
- О передаче возрастного диапазона в Google Play, Справка Google Play.
- AB 1856, Chapter 184, Statutes of 2026, California Legislative Information; вносит изменения в Civil Code с 1798.500 по 1798.504.
- Региональные меры защиты по возрасту в Play, Android Developers, обновлено 18 ноября 2026 года.
- Expo AgeRange, документация Expo; пакет expo-age-range 58.0.3.
- age_range_signals, pub.dev, версия 0.10.1 от 6 октября 2026.
- react-native-play-age-range-declaration, GitHub, версия 3.0.5.
- unity-play-age-signals, GitHub, обновлено 4 августа 2026.
- Play Age Signals API Support, Unity Discussions, ответ команды Unity от декабря 2025.
- Code of Alabama 8-19K-9 (HB 161), легислатура Алабамы.
- Utah Code 13-76-202, легислатура Юты; обязанности разработчиков с 6 мая 2027.
- Decreto 12.880 от 18 марта 2026, ст. 25, Planalto, Бразилия.
- Create session, документация Didit.
- Android SDK, документация Didit.
- Age Estimation overview, документация Didit.
- Biometric consent, документация Didit.
- Webhooks, документация Didit.
- Data retention, документация Didit.
- Native SDKs overview, документация Didit.
- FakeAgeSignalsManager reference, Android Developers, обновлено 18 ноября 2026.
Внедрите эти три вызова, протестируйте каждую строку таблицы и сохраняйте сигнал там, где этого требуют условия Google: в вашем приложении. Для сценариев, на которые он не дает ответа, добавьте оценку возраста в качестве собственной проверки.
Добавьте проверку для пользователей без сигнала
Запросите демо оценки возраста в вашем приложении или создайте сценарий и запустите сессию уже сегодня.
Похожие статьи
- Google Play Age Signals API: что изменится в январе 2027 года
- Age assurance for apps: games, social, dating, AI and more
- Age verification API: which one works on apps, web and stores
- Brazil's ECA Digital and Google Play: age signals in your app
- California age verification law 2027: the four rules for apps
- App Store Accountability Acts: Texas, Utah, Louisiana, Alabama