as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
AWS
文档
Support
Contact Us
My Cases
设备
构建
测试
应用发布
相关资源
文档

用户年龄确认

用户年龄确认

美国的某些州(例如德克萨斯州、犹他州和路易斯安那州)已通过法律,要求各应用商店确认用户的年龄、获得未满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的响应状态。有效值:
  • SUCCESS – API成功返回了用户信息。
  • APP_NOT_OWNED – 调用GetUserAgeData API的应用不是从亚马逊应用商店安装的。
  • INTERNAL_TRANSIENT_ERROR – 出现错误。表明错误是暂时性的,重试后可能会解决。可以考虑将最大重试次数设置为2次。
  • INTERNAL_ERROR – 出现错误表明重试不太可能解决错误。
  • FEATURE_NOT_SUPPORTED – 有应用调用了该API,但未经亚马逊授权。
如果responseStatus字段的值为SUCCESS之外的任何值,则响应的所有其他字段都将为null或为空。
userStatus 用户的年龄确认和同意状态。有效值:
  • VERIFIED – 对于年满18周岁的用户,表明该用户的年龄已得到确认。
  • SUPERVISED – 表明家长或监护人表示了对未满18周岁用户的同意。
  • UNKNOWN – 在适用年龄验证法律的司法辖区或地区,用户的年龄和同意状态未得到确认。用户的年龄范围未经确认。
  • ""(空字符串)– 如果用户为现有用户,或者来自未实施年龄确认法律的地区,则值为空。此外,如果应用加入了亚马逊儿童+订阅,则值为空。
ageLower 用户所属年龄范围所包含的年龄下限。有效值为0131618
如果userStatusUNKNOWN或为空,则为null。
ageUpper 用户所属年龄范围所包含的年龄上限。有效值为121517null
如果用户年满18周岁,则为null。
如果userStatusVERIFIEDUNKNOWN或为空,则为null。
userId 已登录个人资料的匿名唯一应用级标识符。
如果userStatusVERIFIEDUNKNOWN或为空,则为null。
mostRecentApprovalDate 自最近一次获得批准的重大变更发生之日起生效。使用ISO 8601格式。
如果用户年满18周岁,则为null(在此情况下同意不适用)。
如果userStatusVERIFIEDUNKNOWN或为空,则为null。

有关如何设置代码和测试GetUserAgeData API的详细信息,请参阅集成和测试GetUserAgeData API

将重大变更通知到亚马逊应用商店

这些年龄确认法律可能会要求您将某些应用变更(称为“重大变更”)通报亚马逊应用商店。您有责任确定何时必须将此类变更通知到亚马逊应用商店。在开发者控制台中更新应用时,可以报告重大变更。

重大变更需要重新征得家长同意

您报告重大变更后,亚马逊应用商店会针对相关司法辖区内未满18周岁的用户启动家长同意工作流程。如果推出应用发行版时未报告重大变更,则无法启动此类工作流程。

家长或监护人可以撤销对未满18周岁的用户使用您应用的同意。如果发生这种情况,则该用户将无法再访问您的应用。亚马逊应用商店将通过一份报告将撤销通知到您,您可以从开发者控制台的“报告”部分下载该报告。该报告会列出使用同一匿名userId(由GetUserAgeData API在其响应中返回)的所有已撤销同意。

用户年龄确认常见问题解答

以下是有关用户年龄确认的常见问题解答 (FAQ)。

问: 年龄确认法律生效后,当前应用版本是否仍可在亚马逊应用商店上架?
是的,当前应用版本可以在亚马逊应用商店上架。但是,您有责任确保您的应用遵守所有适用法律。
问: 如果我的应用发生了重大变更,该如何报告这一情况?
在开发者控制台中完成应用提交流程期间,可以在元数据更新中报告应用的重大变更。
问: 亚马逊如何确保所提供信息的准确性?
在应用中引入重大变更时,您作为开发者,有责任确保提供准确的信息并选择正确的生效日期。
问: 在哪里可以获取有关年龄确认法案的更多信息?
有关更多信息,可以按以下方式查看账单:
问: 作为开发者,我能否访问我宣布重大变更的历史记录?
开发者控制台目前无法提供重大变更提交历史记录。
问: 在我宣布重大变更之后,生效日期过后的客户体验是怎样的?
对于儿童个人资料,家长必须再次表示同意,孩子才能继续使用该应用。如果家长不重新表示同意,则孩子对该应用的访问权限将被撤销。对于成人个人资料,没有任何变化。
问: 如何识别年满18周岁的用户?
要确定用户是否年满18周岁,请使用GetUserAgeData API。响应中的userStatusVERIFIED,且ageLower18
问: 如何识别拥有儿童个人资料的用户?
要确定用户是否未满18周岁,请使用GetUserAgeData API。响应中的userStatusSUPERVISED,且ageLowerageUpper的值不为null。
问: 如何将应用的分发范围限制在路易斯安那州、德克萨斯州、犹他州或其他州?
亚马逊应用商店不支持以州为单位限制应用分发。

Last updated: 2025年11月6日