了解年龄信号响应

本文档介绍了 Play Age Signals API 返回的年龄信号响应。

（可选）接收自定义年龄范围

API 返回的默认年龄段为 0-12、13-15、16-17 和 18+。

或者，您也可以根据应用的最低年龄要求来自定义默认年龄段，只需在 Google Play 管理中心的年龄信号页面上提供应用的最低年龄要求即可。

  1. 前往 Play 管理中心内的年龄信号页面。
  2. 在自定义年龄段标签页中，为您的应用输入最多三个最低年龄。最低年龄之间必须至少相差 2 岁，且每年只能更改一次。
  3. 点击保存。

返回的年龄段将替换默认 API 响应。例如：

  • 如果您在 Google Play 管理中心内设置了一个最低年龄要求 (15 周岁)，则：
    • 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（Beta 版）响应包含以下字段和值。您有责任使用这些信号提供符合年龄的体验。

响应字段 类型 值 说明
ageRangeSource 枚举
  • TIER_A
  • TIER_B
  • TIER_C
  • TIER_D
  • null
  • TIER_A：用户已自行声明年龄。
  • TIER_B：用户的年龄由家长或监护人管理。
  • TIER_C：使用信用卡、电子邮件地址、自拍照评估、政府签发的身份证件或税务 ID 来评估用户的年龄。
  • TIER_D：通过使用身份证件和自拍评估或数字身份证件的组合来检查用户的年龄。
  • null：当 ageSignalsStatus 为 NOT_SHARED 或 VERIFICATION_REQUIRED 时返回。
ageLower 整数
  • 0 至 18
  • null
 用户年龄段的含下限。将其与 ageUpper 结合使用，以确定年龄段。

如果 ageSignalsStatus 为 NOT_SHARED 或 VERIFICATION_REQUIRED，则返回 null。
ageUpper 整数
  • 2 至 18
  • null
 用户年龄段的含上限。

如果年龄段为最高年龄段（例如 18 岁以上），或者 ageSignalsStatus 为 NOT_SHARED 或 VERIFICATION_REQUIRED，则返回 null。
significantChangeStatus 枚举
  • 已获批
  • PENDING
  • 不参加
  • null
 此函数仅在适用重大变更的司法管辖区内返回非 null 值。
  • 已获批：最新的重大更改（以及之前的所有更改）已获批准。
  • 待处理：家长尚未批准一项或多项待处理的重大变更。
  • DECLINED：家长拒绝批准一项或多项重大变更。
  • null：针对以下情况返回：
    • 所有不受监督的账号
    • 尚未记录任何重大变更的受监督账号。
significantChangeApprovalDate 日期
  • DateStamp
  • null
 最近批准的重大更改的生效日期。生效日期在此日期之前的所有变更也已获得批准。如果没有更改，则返回 null。

将其与 `significantChangeStatus` 结合使用，以获取相应重大变更的审批状态
installId 字符串
  • 字母数字
  • null
 Google Play 为受监督的用户安装分配的 ID，用于在应用审批被撤消时通知您。查看有关已撤消的应用审批的文档。

示例 1

如果用户使用数字身份证件验证了自己的年龄，并与应用分享了该信息，您会收到以下信息：

  • ageRangeSource 为 AgeRangeSource.TIER_D。
  • ageLower 是一个数字（例如，18）。
  • ageUpper 为 null。
  • 其他响应字段为 null。

示例 2

对于已声明年龄（自行声明）并与应用分享年龄的成人用户，您会收到以下信息：

  • ageRangeSource 为 AgeRangeSource.TIER_A。
  • ageLower 是一个数字（例如，18）。
  • ageUpper 为 null。
  • 其他响应字段为 null。

示例 3

对于受监督的未成年用户，如果其年龄由监护人管理，且监护人已与应用分享该用户的年龄，您会收到以下信息：

  • ageRangeSource 为 AgeRangeSource.TIER_B。
  • ageLower 是一个数字（例如，13）。
  • ageUpper 是一个数字（例如，15）。
  • 其他响应字段为 null。

示例 4

如果用户（或其家长）未同意分享年龄，您会收到以下信息：

  • ageRangeSource 为 null。
  • ageLower 是 null。
  • ageUpper 为 null。
  • 其他响应字段为 null。

示例 5

对于年龄已通过年龄估测方法（例如自拍评估、信用卡或纳税人识别号）验证的成年用户，如果其与应用分享年龄，您会收到以下信息：

  • ageRangeSource 为 AgeRangeSource.TIER_C。
  • ageLower 是一个数字（例如，18）。
  • ageUpper 为 null。
  • 其他响应字段为 null。

示例 6

对于受监护人管理的受监督未成年用户，如果其年龄已获批重大变更，且安装跟踪处于有效状态，您会收到以下信息：

  • ageRangeSource 为 AgeRangeSource.TIER_B。
  • ageLower 是一个数字（例如，13）。
  • ageUpper 是一个数字（例如，15）。
  • significantChangeStatus 为 SignificantChangeStatus.APPROVED。
  • significantChangeApprovalDate 是日期（例如“2026-01-15”）。
  • installId 是一个字符串标识符（例如“abc123xyz789”）。
上一页
请求年龄信号
下一页
测试年龄信号