このドキュメントでは、Play Age Signals API から返される年齢シグナルの応答について説明します。
（省略可）カスタムの年齢層を受け取る
API が返すデフォルトの年齢層は、0-12、13-15、16-17、18+ です。
また、アプリの最低年齢に応じてデフォルトの年齢層をカスタマイズするには、Google Play Console の年齢シグナル ページでアプリの最低年齢を指定します。
- Google Play Console の [年齢シグナル] ページに移動します。
- [カスタムの年齢層] タブで、アプリの最低年齢を 3 つまで入力します。最低年齢は 2 歳以上離れている必要があり、年に 1 回変更できます。
- [保存] をクリックします。
返される年齢層は、デフォルトの API レスポンスをオーバーライドします。次に例を示します。
- Google Play Console で最低年齢を 1 つ（15 歳）設定した場合:
- 0 ～ 14 歳の場合は
ageLower = 0とageUpper = 14が返されます。 - 15 歳以上の場合は
ageLower = 15が返されます。
- 0 ～ 14 歳の場合は
- 2 つの最低年齢（13 歳と 17 歳）を設定した場合:
- 0 ～ 12 歳の場合は、
ageLower = 0とageUpper = 12が返されます。 - 13 ～ 16 歳の場合は
ageLower = 13とageUpper = 16が返されます。 - 17 歳以上の場合は
ageLower = 17が返されます。
- 0 ～ 12 歳の場合は、
- 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が返されます。
- 0 ～ 10 歳の場合は
年齢シグナルのレスポンス フィールド
Play Age Signals API（ベータ版）のレスポンスには、次のフィールドと値が含まれます。これらのシグナルを使用して年齢に適したエクスペリエンスを提供する責任は、デベロッパーにあります。
| レスポンス フィールド | タイプ | 値 | 説明 |
|---|---|---|---|
| ageRangeSource | 列挙型 |
|
|
| ageLower | Integer |
|
ユーザーの年齢層の下限（境界値を含む）。ageUpper と組み合わせて、年齢層を決定します。 ageSignalsStatus が NOT_SHARED または VERIFICATION_REQUIRED の場合は、null を返します。 |
| ageUpper | Integer |
|
ユーザーの年齢層の上限（境界値を含む）。 最も高い年齢層（18 歳以上など）の場合、または ageSignalsStatus が NOT_SHARED または VERIFICATION_REQUIRED の場合は、null を返します。 |
| significantChangeStatus | 列挙型 |
|
これは、重要な変更が適用される法域でのみ、null 以外の値を返します。
|
| significantChangeApprovalDate | 日付 |
|
直近で承認された重大な変更の発効日。この日付より前の発効日の変更もすべて承認されます。変更がない場合は null を返します。 `significantChangeStatus` と組み合わせて、この重大な変更の承認状況を取得します。 |
| installId | 文字列 |
|
Google Play によって管理対象ユーザーのインストールに割り当てられる ID。アプリの承認の取り消しを通知するために使用されます。取り消されたアプリの承認に関するドキュメントを確認する。 |
例 1
デジタル ID を使用して年齢確認を行った成人ユーザーの場合、次の情報が届きます。
年齢確認が義務付けられている規制対象の地域の場合:
ageRangeSourceはAgeRangeSource.TIER_Dです。ageLowerは数値です（例: 18）。ageUpperはnullです。- その他のレスポンス フィールドは
nullです。
その他の国:
ageRangeSourceはAgeRangeSource.TIER_Aです。ageLowerは数値です（例: 18）。ageUpperはnullです。- その他のレスポンス フィールドは
nullです。
例 2
年齢推定方法（自撮り写真による推定、クレジット カード、納税者番号など）を使用して年齢確認を行った成人ユーザーの場合、次の情報が返されます。
年齢確認が義務付けられている規制対象の地域の場合:
ageRangeSourceはAgeRangeSource.TIER_Cです。ageLowerは数値です（例: 18）。ageUpperはnullです。- その他のレスポンス フィールドは
nullです。
その他の国:
ageRangeSourceはAgeRangeSource.TIER_Aです。ageLowerは数値です（例: 18）。ageUpperはnullです。- その他のレスポンス フィールドは
nullです。
例 3
年齢確認が必須ではない地域に居住し、アプリと年齢確認を共有しているユーザーの場合、以下を受け取ります。
ageRangeSourceはAgeRangeSource.TIER_Aです。ageLowerは数値です（例: 18）。ageUpperはnullです。- その他のレスポンス フィールドは
nullです。
例 4
保護者が年齢を管理し、アプリと共有している管理対象の未成年ユーザーの場合、次の情報が返されます。
ageRangeSourceはAgeRangeSource.TIER_Bです。ageLowerは数値です（例: 13）。ageUpperは数値です（例: 15）。- その他のレスポンス フィールドは
nullです。
例 5
年齢確認が義務付けられていない地域で、年齢の共有に同意していない（または保護者が同意していない）ユーザーの場合、次の情報が返されます。
ageRangeSourceはnullです。ageLowerはnullです。ageUpperはnullです。- その他のレスポンス フィールドは
nullです。
例 6
年齢が保護者によって管理されている管理対象の未成年ユーザーの場合、承認された重大な変更とアクティブなインストール トラッキングにより、次の情報を受け取ります。
ageRangeSourceはAgeRangeSource.TIER_Bです。ageLowerは数値です（例: 13）。ageUpperは数値です（例: 15）。significantChangeStatusはSignificantChangeStatus.APPROVEDです。significantChangeApprovalDateは日付です（例: 「2026-01-15」）。installIdは文字列識別子です（例: "abc123xyz789"）。