如何用 Google Play Age Signals checkAgeSignals() 按司法辖区限制年龄验证?
数据小陈
结论
ageRangeSource 里的 TIER_A、TIER_B、TIER_C、TIER_D 不能用来判断司法辖区。TIER_C 和 TIER_D 只说明年龄核验或评估方式更强,并不代表用户来自 Texas 或其他要求年龄验证的辖区。TIER_A 和 TIER_B 也不能直接推出“无需检查年龄”。某个辖区是否要求年龄验证,应来自独立的辖区或合规判定,或者根据 requestAgeSignalsAccess(Activity) 返回的状态,结合你的合规策略处理。checkAgeSignals 的结果用来判断年龄范围和可信度,不能用来反推地理位置或法律辖区。
为什么不能用 tier 判断辖区
ageRangeSource描述的是年龄如何被建立或验证,比如自我声明、家长管理、信用卡/Government ID/自拍评估等。它本身不是 jurisdiction 字段。- 同一辖区的用户可能有不同 tier:有人用自拍评估得到
TIER_C,有人用家长管理得到TIER_B。 - 不同辖区的用户也可能得到相同 tier:
TIER_C可能来自任何地区,TIER_A也可能出现在允许自我声明的地区或产品流程中。 null只在ageSignalsStatus为NOT_SHARED或VERIFICATION_REQUIRED等情况下返回,不能说明辖区。- 如果合规要求明确要求在 Texas 等辖区必须验证,就需要可审计的辖区来源和可更新的策略引擎,不能靠 tier 代理。
推荐流程
- 先调用
requestAgeSignalsAccess(Activity),按状态处理:VERIFICATION_REQUIRED:进入验证或锁定流程,直到验证完成或满足年龄限制。不要因为后续 tier 是TIER_A或TIER_B就绕过。NOT_SHARED:没有共享结果。若你的辖区策略要求验证,应提示验证或拒绝;若政策允许降级处理,也要明确降级策略。SHARED:再调用checkAgeSignals(AgeSignalsRequest)获取ageRangeSource和年龄范围。
- 用
ageRangeSource判断可信度或来源,用年龄上下界判断年龄门槛。 - 辖区判断放在独立模块,比如服务端策略、合规地理信息、法律配置等,并保留审计日志。不要硬编码 Texas;法规会变,配置应可更新。
- 对
TIER_A和TIER_B不要默认放行:如果当前辖区要求验证,且你的策略不接受自我声明或家长管理,应要求补充验证。对TIER_C和TIER_D也不要默认认为用户一定在要求辖区。 null或UNSPECIFIED视为未知。高风险辖区 fail closed;低风险辖区可按策略放行,但记录原因。
代码示例
下面示例保留原 API 调用方式,重点是把“辖区判断”和“tier 判断”分开。实际枚举名和类型请以 SDK 0.0.4 为准。
// 伪代码:jurisdictionRequiresAgeVerification 来自独立的合规/辖区判定
boolean jurisdictionRequiresAgeVerification = compliancePolicy
.requiresAgeVerification(userJurisdiction);
ageSignalsManager.requestAgeSignalsAccess(activity)
.addOnSuccessListener(status -> {
if (status == AgeSignalsStatus.VERIFICATION_REQUIRED) {
// 要求验证:锁定或进入验证流程
lockUntilVerified();
return;
}
if (status == AgeSignalsStatus.NOT_SHARED) {
if (jurisdictionRequiresAgeVerification) {
requireAgeVerification();
} else {
allowWithFallbackPolicy();
}
return;
}
// SHARED
ageSignalsManager.checkAgeSignals(AgeSignalsRequest.builder().build())
.addOnSuccessListener(result -> {
Integer source = result.ageRangeSource();
boolean knownSource = source != null
&& source != AgeRangeSource.UNSPECIFIED;
boolean strongVerification = knownSource
&& (source == AgeRangeSource.TIER_C
|| source == AgeRangeSource.TIER_D);
// strongVerification 只说明验证方式较强,
// 不能推出 jurisdictionRequiresAgeVerification。
if (jurisdictionRequiresAgeVerification) {
if (!knownSource) {
// 未知:按合规策略拒绝或转人工/补充验证
requireAgeVerification();
} else if (strongVerification) {
// 结合年龄上下界做最终年龄门槛
evaluateAgeBounds(result);
} else {
// TIER_A/TIER_B 在要求验证的辖区不一定够用
// 具体取决于你的合规策略
requireAgeVerification();
}
} else {
// 非要求辖区:可按产品策略处理年龄范围
// 不要因为 TIER_C/TIER_D 就认为用户在要求辖区
allowOrApplyAgeAppropriateExperience(result);
}
});
});
注意事项
SHARED不等于“辖区允许”,也不等于“已满足法律要求”,它只表示共享状态。- 不要把
List.of(AgeRangeSource.TIER_C, AgeRangeSource.TIER_D).contains(ageRangeSource)当作辖区判断;它只能用来理解验证方式。 ageRangeSource的类型、null和UNSPECIFIED的处理要按 SDK 实际定义来写,避免拆箱异常或误判。- 如果涉及法律合规结论,应让法务或合规团队确认辖区规则;技术实现应保持策略可配置、可审计。
- 日志中不要记录超出必要范围的年龄或身份敏感信息。
备注:内容仅供参考。
