使用 Play 年齡信號 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 SUPERVISED, VERIFIED, 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.
          }
        });

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. 按一下 [儲存]。

年齡信號回應

Play 年齡信號 API (Beta 版) 回應包含下列欄位和值。這些值可能會有所變動。如要取得最新值，請在應用程式開啟時要求 API 回應。您有責任使用這些信號，提供適合年齡層的體驗。

回覆範例

通過驗證的使用者會收到以下資訊：

• userStatus 會是 AgeSignalsVerificationStatus.VERIFIED。
• 其他回覆欄位則會留空。

如果是受監護的使用者，您會收到以下訊息：

• userStatus 會是 AgeSignalsVerificationStatus.SUPERVISED。
• ageLower 會是數字 (例如 13)。
• ageUpper 會是數字 (例如 15)。
• mostRecentApprovalDate 會是 Java 日期物件 (例如 2026-01-01)，或是空白 (如果沒有核准重大變更)。
• installID 是 Play 產生的英數字元 ID (例如 550e8400-e29b-41d4-a716-446655441111)。

如果受監護使用者有待核准的重大變更，您會收到下列訊息：

• userStatus 會是 AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING。
• ageLower 會是數字 (例如 13)。
• ageUpper 會是數字 (例如 15)。
• mostRecentApprovalDate 會是 Java 日期物件 (例如 2026-01-01)，或是空白 (如果沒有核准重大變更)。
• installID 是 Play 產生的英數字元 ID (例如 550e8400-e29b-41d4-a716-446655441111)。

處理 API 錯誤代碼

如果應用程式發出 Play Age Signals API (Beta 版) 要求，但呼叫失敗，應用程式會收到錯誤代碼。造成這類錯誤的原因有很多，例如 Play 商店應用程式版本過舊。

重試策略

在使用者處於工作階段中時，建議您實作重試策略，並以最大重試次數做為結束條件，盡可能避免錯誤干擾使用者體驗。