使用 Play Age Signals API（Beta 版）

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

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

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

// 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.
          }
        });

（可选）接收自定义年龄范围

在适用管辖区和地区，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 版）响应包含以下字段和值。这些值可能会发生变化。如果您想要获取最新值，请在应用打开时请求 API 响应。您有责任使用这些信号提供适合相应年龄段的体验。

针对巴西用户的响应示例

在巴西，userStatus 只能为 DECLARED、 UNKNOWN 或 null。

对于声明了年龄并与应用分享年龄的用户，您将收到以下信息：

• userStatus 将为 AgeSignalsVerificationStatus.DECLARED。
• ageLower 将是一个数字（例如 13）。
• ageUpper 将是一个数字或 null（例如 15）。
• 其他响应字段将为 null。

对于年龄未知的用户，您将收到以下信息：

• userStatus 将为 AgeSignalsVerificationStatus.UNKNOWN。
• 其他响应字段将为 null。

对于不与应用分享年龄的用户，您将收到以下信息：

• userStatus 将为 null。
• 其他响应字段将为 null。

用户的年龄 可供分享后，用户状态可能会更改为DECLARED。

针对美国各州用户的响应示例

在美国适用州，userStatus 可以为VERIFIED、 SUPERVISED、SUPERVISED_APPROVAL_PENDING、 SUPERVISED_APPROVAL_DENIED、UNKNOWN 或 null。

对于已验证的用户，您将收到以下信息：

• userStatus 将为 AgeSignalsVerificationStatus.VERIFIED。
• ageLower 将是一个数字（例如 18）。
• ageUpper 将是一个数字或 null（例如 null）。
• 其他响应字段将为 null。

对于受监督的用户，您将收到以下信息：

• userStatus 将为 AgeSignalsVerificationStatus.SUPERVISED。
• ageLower 将是一个数字（例如 13）。
• ageUpper 将是一个数字或 null（例如 15）。
• mostRecentApprovalDate 将是一个 Java 日期对象（例如 2026-01-01) 或 null（如果未批准任何重大变更）。
• installID 将是由 Google Play 生成的字母数字 ID（例如 550e8400-e29b-41d4-a716-446655441111）。

对于有待批准的重大变更的受监督用户，您将收到以下信息：

• userStatus 将为 AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING。
• ageLower 将是一个数字（例如 13）。
• ageUpper 将是一个数字或 null（例如 15）。
• mostRecentApprovalDate 将是一个 Java 日期对象（例如 2026-01-01) 或 null（如果未批准任何重大变更）。
• installID 将是由 Google Play 生成的字母数字 ID（例如 550e8400-e29b-41d4-a716-446655441111）。

处理 API 错误代码

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

重试策略

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