PAYATHON 2026

如何用 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 代理。

推荐流程

  1. 先调用 requestAgeSignalsAccess(Activity),按状态处理:
    • VERIFICATION_REQUIRED:进入验证或锁定流程,直到验证完成或满足年龄限制。不要因为后续 tier 是 TIER_A 或 TIER_B 就绕过。
    • NOT_SHARED:没有共享结果。若你的辖区策略要求验证,应提示验证或拒绝;若政策允许降级处理,也要明确降级策略。
    • SHARED:再调用 checkAgeSignals(AgeSignalsRequest) 获取 ageRangeSource 和年龄范围。
  2. 用 ageRangeSource 判断可信度或来源,用年龄上下界判断年龄门槛。
  3. 辖区判断放在独立模块,比如服务端策略、合规地理信息、法律配置等,并保留审计日志。不要硬编码 Texas;法规会变,配置应可更新。
  4. 对 TIER_A 和 TIER_B 不要默认放行:如果当前辖区要求验证,且你的策略不接受自我声明或家长管理,应要求补充验证。对 TIER_C 和 TIER_D 也不要默认认为用户一定在要求辖区。
  5. 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 实际定义来写,避免拆箱异常或误判。
  • 如果涉及法律合规结论,应让法务或合规团队确认辖区规则;技术实现应保持策略可配置、可审计。
  • 日志中不要记录超出必要范围的年龄或身份敏感信息。

备注:内容仅供参考。