年齢シグナルのレスポンスについて

このドキュメントでは、Play Age Signals API から返される年齢シグナルのレスポンスについて説明します。

（省略可）カスタム年齢層を受け取る

API が返すデフォルトの年齢範囲は、0-12、13-15、16-17、18+ です。

また、Google Play Console の [年齢シグナル] ページでアプリの最低年齢を指定することで、アプリの最低年齢に応じてデフォルトの年齢層をカスタマイズすることもできます。

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

返される年齢範囲は、デフォルトの API レスポンスをオーバーライドします。次に例を示します。

  • Google Play Console で 1 つの最低年齢（15 歳）を設定した場合:
    • 0 ～ 14 歳の場合は ageLower = 0 と ageUpper = 14 が返されます。
    • 15 歳以上の場合は ageLower = 15 が返されます。
  • 2 つの最小年齢（13 歳と 17 歳）を設定した場合:
    • 0 ～ 12 歳の場合は、ageLower = 0 と ageUpper = 12 が返されます。
    • 13 ～ 16 歳の場合は、ageLower = 13 と ageUpper = 16 が返されます。
    • 17 歳以上の場合、ageLower = 17 が返されます。
  • 3 つの最小年齢（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（ベータ版）のレスポンスには、次のフィールドと値が含まれます。これらのシグナルを使用して年齢に適したエクスペリエンスを提供するのは、デベロッパーの責任です。

レスポンス フィールド タイプ 値 説明
ageRangeSource 列挙型
  • TIER_A
  • TIER_B
  • TIER_C
  • TIER_D
  • null
  • TIER_A: ユーザーが年齢を自己申告している。
  • TIER_B: ユーザーの年齢は保護者によって管理されています。
  • TIER_C: クレジット カード、メールアドレス、自撮り写真の評価、政府機関発行の身分証明書、納税者番号を使用してユーザーの年齢を評価します。
  • TIER_D: 政府機関発行の身分証明書と自撮り写真の評価、またはデジタル ID を組み合わせてユーザーの年齢を確認します。
  • null: ageSignalsStatus が NOT_SHARED または VERIFICATION_REQUIRED の場合に返されます。
ageLower Integer
  • 0 ～ 18
  • null
 ユーザーの年齢層の下限（境界値を含む）。ageUpper と組み合わせて帯域を決定します。

ageSignalsStatus が NOT_SHARED または VERIFICATION_REQUIRED の場合、null を返します。
ageUpper Integer
  • 2 ～ 18
  • null
 ユーザーの年齢層の上限（境界値を含む）。

最も高い帯域（18 歳以上など）の場合、または ageSignalsStatus が NOT_SHARED または VERIFICATION_REQUIRED の場合は、null を返します。
significantChangeStatus 列挙型
  • 承認済み
  • 保留中
  • DECLINED（拒否）
  • null
 この関数は、重大な変更が適用される法域でのみ、null 以外の値を返します。
  • 承認済み: 最新の重大な変更（およびそれまでのすべての変更）が承認されています。
  • PENDING: 保護者が 1 つ以上の保留中の重大な変更をまだ承認していません。
  • DECLINED: 保護者が 1 つ以上の重大な変更を承認しなかった。
  • null: 次の場合に返されます。
    • 管理されていないすべてのアカウント
    • まだ大きな変更が記録されていない管理対象アカウント。
significantChangeApprovalDate 日付
  • DateStamp
  • null
 最後に承認された重大な変更の発効日。この日付より前に有効日が設定されている変更もすべて承認されます。変更がない場合は null を返します。

`significantChangeStatus` と組み合わせて、この重大な変更の承認状況を取得します。
installId 文字列
  • 英数字
  • null
 Google Play によって監視対象ユーザーのインストールに割り当てられる ID。アプリの承認の取り消しを通知する目的で使用されます。取り消されたアプリの承認に関するドキュメントを確認します。

例 1

デジタル ID を使用して年齢確認を行い、アプリと共有したユーザーについては、次の情報を受け取ります。

  • ageRangeSource は AgeRangeSource.TIER_D です。
  • ageLower は数値です（例: 18）。
  • ageUpper は null です。
  • 他のレスポンス フィールドは null です。

例 2

年齢を申告（自己申告）し、アプリと共有している成人ユーザーの場合、次の情報を受け取ります。

  • ageRangeSource は AgeRangeSource.TIER_A です。
  • ageLower は数値です（例: 18）。
  • ageUpper は null です。
  • その他のレスポンス フィールドは null です。

例 3

保護者がアプリと共有している年齢を管理している未成年者の管理対象ユーザーの場合、次の情報が返されます。

  • ageRangeSource は AgeRangeSource.TIER_B です。
  • ageLower は数値です（例: 13）。
  • ageUpper は数値です（例: 15）。
  • その他のレスポンス フィールドは null です。

例 4

年齢の共有に同意していないユーザー（または保護者が同意していないユーザー）に対しては、次の情報が返されます。

  • ageRangeSource は null です。
  • ageLower は null です。
  • ageUpper は null です。
  • その他のレスポンス フィールドは null です。

例 5

年齢推定方法（自撮り写真の評価、クレジット カード、納税者番号など）を使用して年齢が確認され、アプリと共有された成人ユーザーの場合、以下の情報が提供されます。

  • ageRangeSource は AgeRangeSource.TIER_C です。
  • ageLower は数値です（例: 18）。
  • ageUpper は null です。
  • その他のレスポンス フィールドは null です。

例 6

保護者によって年齢が管理されている管理対象の未成年ユーザーで、重大な変更が承認され、インストール トラッキングが有効になっている場合、次の情報が提供されます。

  • ageRangeSource は AgeRangeSource.TIER_B です。
  • ageLower は数値です（例: 13）。
  • ageUpper は数値です（例: 15）。
  • significantChangeStatus は SignificantChangeStatus.APPROVED です。
  • significantChangeApprovalDate は日付（「2026-01-15」など）です。
  • installId は文字列識別子（「abc123xyz789」など）です。
前へ
年齢のシグナルをリクエストする
次へ
年齢のシグナルをテストする