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

Play 年齢シグナル API（ベータ版）を使用すると、利用規約に同意したことになり、すべての Google Play デベロッパー ポリシーを遵守することに同意したことになります。ユーザーのステータスと年齢層をリクエストするには、実行時にアプリから API を呼び出します。Play 年齢シグナル API は、Google 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 Console の [年齢シグナル] ページでアプリの最低年齢を指定します。Age Signals API は、カスタマイズされた年齢層を返します。たとえば、年齢の下限として 9 歳、15 歳、17 歳を指定した場合、14 歳のユーザーは 10 ～ 15 歳の年齢範囲に該当します。最低年齢は 2 歳以上離れている必要があり、年に 1 回変更できます。

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

1. Google Play Console の [年齢シグナル] ページに移動します。
2. [アプリの最低年齢] タブで、アプリの最低年齢を 3 つまで入力します。
3. [Save] をクリックします。

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

Play 年齢シグナル API（ベータ版）のレスポンスには、次のフィールドと値が含まれます。値は変更される場合があります。最新の値を取得する場合は、アプリを開いたときに API レスポンスをリクエストします。これらのシグナルを使用して年齢に適したエクスペリエンスを提供するのは、デベロッパーの責任です。

API エラーコードを処理する

アプリが Play Age Signals API（ベータ版）リクエストを行い、呼び出しに失敗すると、アプリはエラーコードを受け取ります。これらのエラーは、Google Play ストア アプリが最新でないなど、さまざまな理由で発生する可能性があります。

再試行戦略

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