本文說明 Play Age Signals API 傳回的年齡信號回應。
(選用) 接收自訂年齡層
API 傳回的預設年齡範圍為 0-12、13-15、16-17 和 18+。
您也可以根據應用程式的最低年齡要求,在 Google Play 管理中心的「年齡信號」頁面提供這些最低年齡,自訂預設年齡層。
傳回的年齡層會覆寫預設 API 回應。例如:
- 如果您在 Google Play 管理中心設定一個最低年齡限制 (15 歲):
- 0 到 14 歲會傳回
ageLower = 0和ageUpper = 14。 - 15 歲以上的使用者會傳回
ageLower = 15。
- 0 到 14 歲會傳回
- 如果您設定兩個最低年齡 (13 歲和 17 歲):
- 0 到 12 歲,會傳回
ageLower = 0和ageUpper = 12。 - 13 到 16 歲的使用者會傳回
ageLower = 13和ageUpper = 16。 - 17 歲以上的使用者會傳回
ageLower = 17。
- 0 到 12 歲,會傳回
- 如果您設定三個最低年齡 (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 (Beta 版) 回應包含下列欄位和值。您有責任使用這些信號提供適齡體驗。
| 回應欄位 | 類型 | 值 | 說明 |
|---|---|---|---|
| ageRangeSource | 列舉 |
|
|
| ageLower | 整數 |
|
使用者年齡範圍的下限 (含)。與 ageUpper 搭配使用,即可決定年齡層。 如果 ageSignalsStatus 為 NOT_SHARED 或 VERIFICATION_REQUIRED,則傳回 null。 |
| ageUpper | 整數 |
|
使用者年齡範圍的上限 (含)。 如果年齡層最高 (例如 18 歲以上),或 ageSignalsStatus 為 NOT_SHARED 或 VERIFICATION_REQUIRED,則會傳回 null。 |
| significantChangeStatus | 列舉 |
|
只有在適用重大異動的管轄區,這個方法才會傳回非空值。
|
| significantChangeApprovalDate | 日期 |
|
最近一次核准的重大變更生效日期。生效日期早於此日期的所有變更也已核准。如果沒有任何變更,則傳回 null。 與 `significantChangeStatus` 搭配使用,即可取得這項重大變更的核准狀態 |
| installId | String |
|
Google Play 指派給受監護使用者安裝項目的 ID,用於通知您應用程式核准狀態已撤銷。請參閱撤銷應用程式核准的說明文件。 |
範例 1
如果成人使用者透過數位身分證件驗證年齡,您會收到下列資訊:
在強制要求年齡驗證的管制地區:
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是字串 ID (例如「abc123xyz789」)。