Play Age Signals API（ベータ版）を使用する

// 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 Console の [年齢シグナル] ページでアプリの最低年齢を指定することで、アプリの最低年齢に応じてデフォルトの年齢層をカスタマイズすることもできます。返される年齢範囲は、デフォルトの API レスポンスをオーバーライドします。たとえば、最低年齢を 9 歳、15 歳、17 歳と指定した場合、14 歳のユーザーは 10 ～ 15 歳の年齢層に分類されます。

Age Signals API から返されるデフォルトの年齢層をカスタマイズするには、アプリの最低年齢を指定します。

1. Google Play Console の [年齢シグナル] ページに移動します。
2. [カスタム年齢層] タブで、アプリの最低年齢を 3 つまで入力します。最低年齢は 2 歳以上離れている必要があり、年に 1 回変更できます。
3. [Save] をクリックします。

年齢シグナルのレスポンス

Play Age Signals API（ベータ版）のレスポンスには、次のフィールドと値が含まれます。値は変更される場合があります。最新の値が必要な場合は、アプリを開いたときに 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 リクエストを行い、呼び出しに失敗すると、アプリはエラーコードを受け取ります。これらのエラーは、Google Play ストア アプリが最新でないなど、さまざまな理由で発生する可能性があります。

再試行戦略

ユーザーがセッション中の場合は、エラーによってユーザー エクスペリエンスをできる限り妨げることがないよう、終了条件として最大試行回数を設定した再試行手段を実行することをおすすめします。