了解年龄信号响应

本文档介绍了 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:用户已向 Google 提供其年龄信息。Google 可能已确认这些信息,也可能未确认。
  • TIER_B:用户的年龄由家长或监护人管理。
  • TIER_C*:用户的年龄通过信用卡、邮箱、自拍照评估、政府身份证件或税号进行评估。
  • 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 值。
  • 已批准:最近的重大更改(以及之前的所有更改)已获批准。
  • PENDING:家长尚未批准一项或多项待处理的重大更改。
  • DECLINED:家长拒绝批准一项或多项重大变更。
  • null:在以下情况下返回:
    • 所有不受监督的账号
    • 尚未记录任何重大更改的受监督的账号。
significantChangeApprovalDate 日期
  • DateStamp
  • null
最近一次获批的重大更改的生效日期。生效日期早于此日期的所有更改也均已获批。如果不存在任何更改,则返回 null。

将其与 `significantChangeStatus` 结合使用,即可获取此重大变更的审批状态

installId 字符串
  • 字母数字
  • null
Google Play 为受监督用户安装的应用分配的 ID,用于在应用批准被撤销时通知您。查看有关撤销应用批准的文档。

示例 1

对于通过数字身份证件验证年龄的成年用户,您会收到以下信息:

  • 在强制要求进行年龄验证的受监管地区:

    • ageRangeSource 为 AgeRangeSource.TIER_D。
    • ageLower 是一个数字(例如 18)。
    • ageUpper 为 null。
    • 其他响应字段为 null。
  • 其他所有地区:

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

示例 2

对于通过年龄估测方法(例如自拍照评估、信用卡或税号)验证年龄的成年用户,您会收到以下信息:

  • 在强制要求进行年龄验证的受监管地区:

    • ageRangeSource 为 AgeRangeSource.TIER_C。
    • ageLower 是一个数字(例如 18)。
    • ageUpper 为 null。
    • 其他响应字段为 null
  • 其他所有地区:

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

示例 3

对于位于不强制要求进行年龄验证的地区,且选择与应用分享年龄的用户,您会收到以下信息:

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

示例 4

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

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

示例 5

对于未同意(或其家长未同意)分享年龄信息的用户,如果其所在地区不强制要求进行年龄验证,您会收到以下信息:

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

示例 6

对于年龄由监护人管理的受监管未成年用户,如果其存在已获批的重大变更且已启用安装跟踪,您会收到以下响应:

  • ageRangeSource 为 AgeRangeSource.TIER_B。
  • ageLower 是一个数字(例如 13)。
  • ageUpper 是一个数字(例如 15)。
  • significantChangeStatus 为 SignificantChangeStatus.APPROVED。
  • significantChangeApprovalDate 是日期(例如“2026-01-15”)。
  • installId 是字符串标识符(例如“abc123xyz789”)。