降级会将您的 reCAPTCHA 项目转换为较低的产品层级。当项目不再满足当前层级的资格条件时,就会发生这种情况。
项目降级的原因
层级转换通常是由于以下某种原因造成的:
- 从企业版降级到高级版: 您的企业版订阅已过期、失效或不再有效,或者项目已与具有有效订阅的账号解除关联。
- 从高级版降级到基本版: 与您的 Google Cloud 项目关联的结算账号已解除关联、已停用或存在结算问题,例如未结款项。
宽限期
欺诈防护功能为从企业版降级到高级版提供 30 天的宽限期。在此期间,您仍可使用企业版功能,以便解决结算问题或更新集成。30 天的宽限期结束后,您将无法再使用企业版专享功能。
对功能的影响
降级会减少项目中可用的功能,以匹配目标层级:
- 降级到高级版: 您将无法再使用企业版专享功能。如需对照比较功能,请参阅功能比较表。
- 降级到基本版: 您将无法再使用高级版功能,并且每月免费评估次数上限为 10,000 次。超出此限制的评估会返回
HTTP 429 (Resource Exhausted)错误。
对现有集成的影响
根据您使用的功能,降级可能会导致 API 错误或界面变更:
- 高级原因代码:
CreateAssessment响应不再包含extended_verdict_reasons字段中的高级原因。如果您的后端依赖于这些代码,请更新后端以使用标准分类原因。 - 相关账号 API: 对相关账号端点的调用会返回
PERMISSION_DENIED错误。您必须停止调用这些 API。 - 交易防护: 如果您在未发送前端令牌的情况下请求交易评估,API 会返回
PERMISSION_DENIED错误。如需继续使用 Transaction Defense,您必须实现前端集成。 - ATO 分析:
accountTakeoverVerdict字段为空或在accountDefenderAssessment响应中缺失。必须更新预期此字段的后端逻辑,以避免出错。 - 仅限界面的功能: 控制台中不再显示特定于网站的欺诈报告和攻击调查等功能。 Google Cloud
验证功能使用情况
如需确定集成是否会受到降级的影响,请验证以下内容:
- 检查后端代码,查看评估响应中是否有对
extended_verdict_reasons(请参阅解读网站评估)或accountTakeoverVerdict(请参阅检测和防范账号盗用)的引用。 - 检查后端是否调用任何 相关账号 API 端点。
- 检查您是否在没有前端令牌的情况下进行交易评估(请参阅安装交易防护)。
防止降级或从降级中恢复
如需防止服务中断或恢复对功能的访问权限,请解决结算或订阅问题:
- 恢复企业版状态: 将您的项目与具有有效 Fraud Defense 订阅的有效结算账号相关联。如果您需要新订阅,请与您的 Google Cloud 销售代表或Google Cloud 销售团队联系。
- 恢复高级版状态: 确保您的项目与有效的有效 Google Cloud 结算账号相关联。