本文档介绍了 Play Age Signals API 返回的年龄信号响应。
(可选)接收自定义年龄段
API 返回的默认年龄段为 0-12、13-15、16-17 和 18+。
或者,如需根据应用的最低年龄要求自定义默认年龄段,您可以在 Google Play 管理中心的“年龄信号”页面上提供应用的这些最低年龄要求。
- 前往 Play 管理中心内的年龄信号页面。
- 在自定义年龄段标签页中,为您的应用输入最多三个最低年龄。最低年龄之间必须至少相差 2 岁,且每年只能更改一次。
- 点击保存。
返回的年龄段将覆盖默认 API 响应。例如:
- 如果您在 Google Play 管理中心内设置了一个最低年龄 (15):
- 0 至 14 岁的用户将返回
ageLower = 0和ageUpper = 14。 - 15 岁以上将返回
ageLower = 15。
- 0 至 14 岁的用户将返回
- 如果您设置了两个最低年龄(13 岁和 17 岁):
- 对于 0 到 12 岁的用户,系统会返回
ageLower = 0和ageUpper = 12。 - 13 至 16 周岁的用户将返回
ageLower = 13和ageUpper = 16。 - 17 岁以上的用户将返回
ageLower = 17。
- 对于 0 到 12 岁的用户,系统会返回
- 如果您设置了三个最低年龄(11、13 和 15):
- 0 至 10 岁的儿童将返回
ageLower = 0和ageUpper = 10。 - 11 岁或 12 岁的用户将返回
ageLower = 11和ageUpper = 12。 - 13 或 14 岁的用户将返回
ageLower = 13和ageUpper = 14。 - 15 岁以上的人会返回
ageLower = 15。
- 0 至 10 岁的儿童将返回
年龄信号响应字段
Play Age Signals API(Beta 版)响应包含以下字段和值。您有责任根据这些信号提供符合年龄的体验。
| 响应字段 | 类型 | 值 | 说明 |
|---|---|---|---|
| ageRangeSource | 枚举 |
|
|
| ageLower | 整数 |
|
用户年龄范围的下限(含)。与 ageUpper 结合使用,以确定年龄段。
如果 ageSignalsStatus 为 NOT_SHARED 或 VERIFICATION_REQUIRED,则返回 null。 |
| ageUpper | 整数 |
|
用户年龄范围的上限(含)。
如果年龄段为最高年龄段(例如 18+),或者 ageSignalsStatus 为 NOT_SHARED 或 VERIFICATION_REQUIRED,则返回 null。 |
| significantChangeStatus | 枚举 |
|
仅在适用重大变更的管辖区内,此方法才会返回非 null 值。
|
| significantChangeApprovalDate | 日期 |
|
最近一次获批的重大更改的生效日期。生效日期早于此日期的所有更改也均已获批。如果不存在任何更改,则返回 null。
将其与 `significantChangeStatus` 结合使用,即可获取此重大变更的审批状态 |
| installId | 字符串 |
|
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”)。