使用 Play Age Signals API（Beta 版）

使用 Play Age Signals API（Beta 版）即表示您同意遵守服务条款，并同意遵守所有 Google Play 开发者政策。如需请求用户的状态和年龄段，您可以在运行时从应用中调用该 API。Play Age Signals API 仅返回以下区域中用户的数据：根据法律规定，Play 必须提供年龄段数据的区域。

Play 会根据适用管辖区和地区定义的年龄段返回年龄范围。在适用司法管辖区和地区，API 返回的默认年龄段为 0-12、13-15、16-17 和 18 岁以上，但这些年龄段可能会根据地区要求而发生变化。

将 Play Age Signals API 集成到您的应用中

如需将 Play Age Signals API 集成到您的应用中，请将以下依赖项添加到应用的 build.gradle 文件中：

implementation 'com.google.android.play:age-signals:0.0.1-beta01'

请求年龄信号

以下示例展示了如何发出年龄信号请求：

// Create an instance of a manager
AgeSignalsManager ageSignalsManager =
    AgeSignalsManagerFactory.create(ApplicationProvider.getApplicationContext());

// Request an age signals check
ageSignalsManager
    .checkAgeSignals(AgeSignalsRequest.builder().build())
    .addOnSuccessListener(
        ageSignalsResult -> {
          // Store the install ID for later...
          String installId = ageSignalsResult.installId();

          if (ageSignalsResult
              .userStatus()
              .equals(AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_DENIED)) {
            // Disallow access ...
          } else {
            // Do something else if the user is SUPERVISED, VERIFIED, etc.
          }
        });

Google Play 会在设备上为每位用户存储年龄信号。当受监督的 Google 账号的用户进入新的年龄段时，Google Play 会在用户生日后的 2 到 8 周内自动更新该用户的缓存年龄信号。

（可选）接收自定义年龄段

在适用的司法管辖区和地区，该 API 返回的默认年龄段为 0-12、13-15、16-17 和 18 岁以上。这些年龄段将来可能会根据当地要求而发生变化。

或者，如需根据应用的最低年龄值自定义年龄范围，您可以在 Google Play 管理中心的年龄信号页面上为应用提供这些最低年龄值。Age Signals API 会返回自定义的年龄范围。例如，如果您提供的最低年龄为 9 岁、15 岁和 17 岁，那么 14 岁的用户将属于 10-15 岁的年龄段。最低年龄必须至少相差 2 周岁，并且每年只能更改一次。

如需自定义 Age Signals API 返回的年龄范围，您可以为应用提供最低年龄值：

1. 前往 Play 管理中心内的年龄信号页面。
2. 在应用的最低年龄要求标签页中，输入应用的最低年龄要求（最多三个）。
3. 点击 Save。

年龄信号响应

Play Age Signals API（Beta 版）响应包含以下字段和值。这些值可能会发生变化。如果您需要最新值，请在应用打开时请求 API 响应。您有责任使用这些信号提供符合年龄的体验。

处理 API 错误代码

如果您的应用发出 Play Age Signals API（Beta 版）请求，但调用失败，则您的应用会收到一个错误代码。这些错误可能是由各种原因造成的，例如 Play 商店应用过时。

重试策略

当用户正在会话中时，我们建议实现一个重试策略，将尝试次数上限作为退出条件，以便尽可能避免错误干扰用户体验。