使用 Play 年齡信號 API (Beta 版)

使用 Play 年齡信號 API (測試版) 即表示您同意服務條款，並同意遵守所有 Google Play 開發人員政策。如要要求取得使用者的狀態和年齡層，請在執行階段從應用程式呼叫 API。Play Age Signals API 只會傳回使用者位於特定區域的資料，因為 Play 必須依法提供這些區域的年齡類別資料。

Play 會根據適用管轄區和區域定義的年齡層，傳回年齡範圍。在適用管轄區和地區，API 預設會傳回 0-12 歲、13-15 歲、16-17 歲和 18 歲以上年齡層，但這些年齡層可能會根據地區規定而異。

將 Play 年齡信號 API 整合到應用程式中

如要將 Play 年齡信號 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. 按一下 [儲存]。

年齡信號回應

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

處理 API 錯誤代碼

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

重試策略

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