用户年龄确认
美国的某些州(例如德克萨斯州、犹他州和路易斯安那州)已通过法律,要求各应用商店确认用户的年龄、获得未满18周岁用户的父母同意,并与开发者共享用户年龄信息。这些法律还要求开发者必须遵守特定的义务,才能在这些州通过亚马逊应用商店分发应用。亚马逊应用商店即将提供一个API来帮助您遵守这些法律。
本页讲解了如何执行以下操作:
- 使用亚马逊的GetUserAgeData API(“API”)获取用户的年龄相关信号。
- 向亚马逊应用商店告知需要重新征得家长同意的应用重大变更。
- 接收有关您的应用已撤销的家长同意的通知。
使用GetUserAgeData API时须遵守亚马逊应用商店开发者服务协议(仅提供英文版)。您有责任确保您的应用符合所有适用法规和亚马逊应用商店政策。
GetUserAgeData API
您的应用可通过查询亚马逊的GetUserAgeData API来检索用户的年龄确认状态和年龄信号。该API可以为适用司法辖区的用户提供以下信息:
- 基于以下年龄范围之一的年龄信号:
- 0-12周岁
- 13-15周岁
- 16-17周岁
- 年满18周岁
- 对于未满18周岁的用户,当前应用版本的家长同意状态。
根据这些信号,您有责任在您的应用内提供适合用户年龄的体验。
用法
要访问亚马逊的GetUserAgeData API,请使用Android的ContentProvider API。该API的基本查询用法如下所示。
Cursor cursor = getContentResolver().query(
Uri.parse("content://amzn_appstore/getUserAgeData"),
null, null, null, null, null);
如需查看更多详细示例,请参阅集成和测试GetUserAgeData API。
响应结构
GetUserAgeData API可提供JSON格式的响应,如以下示例所示。有关每个字段的详细信息,请查看本节的表格。
示例响应:适用于成人用户(年满18周岁)
{
"responseStatus": "SUCCESS",
"userStatus": "VERIFIED",
"ageLower": 18, // 如果用户年满18周岁,则始终为18
"ageUpper": null, // 如果用户年满18周岁,则始终为null
"userId": null, // 对年满18周岁的用户不适用
"mostRecentApprovalDate": null // 对年满18周岁的用户不适用
}
示例响应:适用于未成年用户(未满18周岁)
{
"responseStatus": "SUCCESS",
"userStatus": "SUPERVISED",
"ageLower": 0,
"ageUpper": 12,
"userId": "<唯一ID>",
"mostRecentApprovalDate": "2026-01-01T12:00:00Z"
}
GetUserAgeData API响应包含以下字段和值。
| 字段 | 描述 |
|---|---|
responseStatus |
GetUserAgeData API的响应状态。有效值:
responseStatus字段的值为SUCCESS之外的任何值,则响应的所有其他字段都将为null或为空。 |
userStatus |
用户的年龄确认和同意状态。有效值:
|
ageLower |
用户所属年龄范围所包含的年龄下限。有效值为0、13、16和18。如果 userStatus为UNKNOWN或为空,则为null。 |
ageUpper |
用户所属年龄范围所包含的年龄上限。有效值为12、15、17和null。如果用户年满18周岁,则为null。 如果 userStatus为VERIFIED、UNKNOWN或为空,则为null。 |
userId |
已登录个人资料的匿名唯一应用级标识符。 如果 userStatus为VERIFIED、UNKNOWN或为空,则为null。 |
mostRecentApprovalDate |
自最近一次获得批准的重大变更发生之日起生效。使用ISO 8601格式。 如果用户年满18周岁,则为null(在此情况下同意不适用)。 如果 userStatus为VERIFIED、UNKNOWN或为空,则为null。 |
有关如何设置代码和测试GetUserAgeData API的详细信息,请参阅集成和测试GetUserAgeData API。
将重大变更通知到亚马逊应用商店
这些年龄确认法律可能会要求您将某些应用变更(称为“重大变更”)通报亚马逊应用商店。您有责任确定何时必须将此类变更通知到亚马逊应用商店。在开发者控制台中更新应用时,可以报告重大变更。
您报告重大变更后,亚马逊应用商店会针对相关司法辖区内未满18周岁的用户启动家长同意工作流程。如果推出应用发行版时未报告重大变更,则无法启动此类工作流程。
撤销同意的通知
家长或监护人可以撤销对未满18周岁的用户使用您应用的同意。如果发生这种情况,则该用户将无法再访问您的应用。亚马逊应用商店将通过一份报告将撤销通知到您,您可以从开发者控制台的“报告”部分下载该报告。该报告会列出使用同一匿名userId(由GetUserAgeData API在其响应中返回)的所有已撤销同意。
用户年龄确认常见问题解答
以下是有关用户年龄确认的常见问题解答 (FAQ)。
- 问: 年龄确认法律生效后,当前应用版本是否仍可在亚马逊应用商店上架?
- 是的,当前应用版本可以在亚马逊应用商店上架。但是,您有责任确保您的应用遵守所有适用法律。
- 问: 如果我的应用发生了重大变更,该如何报告这一情况?
- 在开发者控制台中完成应用提交流程期间,可以在元数据更新中报告应用的重大变更。
注意: 如果使用应用提交API更新应用,则您有责任以通过开发者控制台提交元数据更新的方式报告任何重大变更。
- 问: 亚马逊如何确保所提供信息的准确性?
- 在应用中引入重大变更时,您作为开发者,有责任确保提供准确的信息并选择正确的生效日期。
- 问: 在哪里可以获取有关年龄确认法案的更多信息?
- 有关更多信息,可以按以下方式查看账单:
- 问: 作为开发者,我能否访问我宣布重大变更的历史记录?
- 开发者控制台目前无法提供重大变更提交历史记录。
- 问: 在我宣布重大变更之后,生效日期过后的客户体验是怎样的?
- 对于儿童个人资料,家长必须再次表示同意,孩子才能继续使用该应用。如果家长不重新表示同意,则孩子对该应用的访问权限将被撤销。对于成人个人资料,没有任何变化。
- 问: 如何识别年满18周岁的用户?
- 要确定用户是否年满18周岁,请使用GetUserAgeData API。响应中的
userStatus为VERIFIED,且ageLower为18。 - 问: 如何识别拥有儿童个人资料的用户?
- 要确定用户是否未满18周岁,请使用GetUserAgeData API。响应中的
userStatus为SUPERVISED,且ageLower和ageUpper的值不为null。 - 问: 如何将应用的分发范围限制在路易斯安那州、德克萨斯州、犹他州或其他州?
- 亚马逊应用商店不支持以州为单位限制应用分发。
相关主题
Last updated: 2025年11月6日

