了解年龄信号响应

本文档介绍了 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 枚举
  • APPROVED
  • PENDING
  • DECLINED
  • null
 此字段仅在适用重大更改的管辖区中返回非 null 值。
  • APPROVED：最近的重大更改（以及之前的所有更改）已获批准。
  • 待处理：家长尚未批准一项或多项待处理的重大更改。
  • 已拒绝：家长拒绝批准一项或多项重大更改。
  • null：针对以下情况返回：
    • 所有不受监督的账号
    • 尚未记录任何重大更改的受监督账号。
significantChangeApprovalDate 日期
  • 时间戳
  • 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

对于年龄通过年龄估测方法（例如自拍照评估、信用卡或税务 ID）进行评估并与应用分享年龄的成人用户，您会收到以下信息：

  • 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”）。
上一页
请求年龄信号
下一页
测试年龄信号