常见问题解答

了解您在使用 reCAPTCHA 时可能会遇到的常见问题或疑问。

实现

我可以在全球范围内使用 reCAPTCHA 吗？

可以，如果您的用户无法访问 www.google.com，您可以在前端代码中使用 www.recaptcha.net。

  • 首先，将 <script src="https://www.google.com/recaptcha/enterprise.js?render=<SITE_KEY>"></script> 替换为 <script src="https://www.recaptcha.net/recaptcha/enterprise.js?render=<SITE_KEY>"></script>，并用您的网站密钥替换 <SITE_KEY>。
  • 然后，对网站上的所有 www.google.com/recaptcha/ 实例执行同样的操作。

reCAPTCHA 是否使用 Cookie？

在执行时，reCAPTCHA 会设置必要的 Cookie (_GRECAPTCHA)，以便提供风险分析。 如果您不想使用可能设置了其他 Cookie 的 www.google.com 网域，可以改用 www.recaptcha.net。

我想隐藏 reCAPTCHA 徽章。允许哪些行为？

只要您使用 reCAPTCHA 保护网站，就可以隐藏此徽章。请添加以下文本：

This site is protected by reCAPTCHA.

例如：

“由 reCAPTCHA 提供保护”消息的示例

了解 reCAPTCHA 数据处理。

我可以自定义 reCAPTCHA 微件或徽章吗？

可以。reCAPTCHA 提供浅色和深色主题。如需选择 主题，请在呈现微件或徽章时设置 data-theme 属性或 theme 参数。

  • 浅色主题：
    采用浅色主题的 reCAPTCHA widget 或徽章

  • 深色主题：
    采用深色主题的 reCAPTCHA widget 或徽章

我在网站上使用了内容安全政策 (CSP)。如何配置它以与 reCAPTCHA 搭配使用？

我们建议您使用 CSP3 中记录的方法。 请务必在 reCAPTCHA enterprise.js 脚本标记中添加只能使用一次的数字，我们会处理其余部分。

或者，将以下值添加到指令：

  • script-src https://www.google.com/recaptcha/, https://www.gstatic.com/recaptcha/
  • frame-src https://www.google.com/recaptcha/, https://recaptcha.google.com/recaptcha/
  • connect-src https://www.google.com/recaptcha/

我可以在控制台的“验证网域”列表中添加多少个网域？ Google Cloud

每个密钥最多可添加 250 个网域。

如需在超过 250 个网域中使用密钥，请参阅为网站创建密钥。

我使用的第三方插件实现不正式支持 reCAPTCHA 的 Cloud API，而仅支持旧版 reCAPTCHA API siteverify。我还可以继续使用 reCAPTCHA 吗？

可以，您可以在 Google Cloud 控制台中找到旧版密钥。如需了解如何查找旧版密钥，请参阅查找旧版 reCAPTCHA 密钥。

在调试网站时，如何避免进入 reCAPTCHA 代码？

如需避免在调试网站上的其他 JavaScript 时进入 reCAPTCHA 代码，请将 reCAPTCHA 脚本 /recaptcha__.+\.js$ 添加到浏览器的忽略列表中。如需了解 Chrome 的相关说明，请参阅忽略自定义脚本列表。其他浏览器也提供类似的功能。

为什么仅在 iOS 10 上，用户完成挑战后页面会滚动到底部？

这是一个焦点 bug，我们已向 Apple 报告。 它仅影响 iOS 10 上的用户，并且仅在某些网站上出现。如果您受到影响，一种解决方法是将 reCAPTCHA 微件在页面上向上或向下移动。

用法

我对 reCAPTCHA 的使用是否有限制？

是，请参阅配额和限制。

reCAPTCHA 信息中心使用哪个时区？我可否对此作出更改？

此时区根据浏览器的客户端时区确定。目前无法更改此设置。

如何衡量 reCAPTCHA 返回的得分的质量？

得分质量最终取决于您的使用场景和所需的结果。一般来说，我们建议您使用您自己的用户行为内部指标，以确定得分是否准确，例如：

  • 重置了密码并获得最高得分的用户稍后是否报告其账号被盗用？
  • 已登录但得分较低的用户会继续向其他人发送垃圾邮件吗？
  • 登录失败并获得低分的用户会继续尝试使用多个不同用户名登录吗？

如何查看有关网站流量的更多信息？

您可以在 Google Cloud 控制台 的 reCAPTCHA 页面上查看详细信息。

我想使用 reCAPTCHA 运行自动化测试。该怎么做？

您可以使用 Google Cloud CLI创建用于测试的 reCAPTCHA 网站密钥。如需了解详情，请参阅 recaptcha keys create reference 页面中的 --testing-challenge 和 --testing-score 选项。

示例

  • 创建始终返回“No CAPTCHA”（无质询）和 1.0 的复选框网站密钥（请在下面更改 --网域 和 --显示名 ）。
gcloud recaptcha keys create --testing-challenge=nocaptcha --testing-score=1.0 --web --domains="domain1.com,domain2.com" --display-name="Always No CAPTCHA" --integration-type=checkbox
  • 创建始终返回不可解决的挑战的复选框网站密钥（请在下面更改 --网域 和 --显示名）。
gcloud recaptcha keys create --testing-score=0.0 --testing-challenge=challenge --web --domains="domain1.com,domain2.com" --display-name="Unsolvable Challenge" --integration-type=checkbox
  • 创建始终返回设定得分的基于得分的网站密钥（请在下面更改 --网域 、--显示名称 和 --测试得分 ）。
gcloud recaptcha keys create --testing-score=1.0 --web --domains="domain1.com,domain2.com" --display-name="Always 1" --integration-type=score

我想与 reCAPTCHA REST API 通信。我可以假设响应格式将来不会改变吗？

随着产品的发展，我们可能会应用非重大更改，例如向 API 添加新字段。如果您使用 JSON，请确保您没有严格验证响应的格式，以保持与 API 将来的添加兼容性。

如果我想创建传统版 reCAPTCHA 密钥，有哪些选择？

您无法再创建新的传统版密钥。如果您有现有的传统版密钥，我们建议您从 reCAPTCHA Classic 迁移。所有 Google Cloud reCAPTCHA 客户每月都可以免费创建 10,000 次评估。如需详细了解使用情况和价格，请参阅 reCAPTCHA 价格。

数据处理

了解 reCAPTCHA 数据处理

从 2026 年 4 月 2 日起，从 reCAPTCHA 徽章和客户网站中移除 Google 的隐私权政策和服务条款引用会带来哪些影响？有哪些建议？

从 2026 年 4 月 2 日起，reCAPTCHA 徽章中将移除对 Google 的隐私权政策和使用条款的引用，以反映客户作为数据控制方和 Google 作为客户数据的数据处理方的角色。虽然这些链接对于其他 Google 产品仍将有效，但我们建议客户主动从自己的网站中移除这些引用，以确保准确性。如有需要，您可以继续隐藏 reCAPTCHA 徽章。

客户是否担任数据控制方的角色？

reCAPTCHA 客户一直是其最终用户数据的数据控制方。不过，Google 始终认为，在提供 reCAPTCHA 时，Google 担任独立的数据控制方。通过转变为数据处理方，Google 将放弃确定客户数据的处理目的和方式的能力，因此 reCAPTCHA 客户应移除对 Google 隐私权政策和使用条款的引用。从 2026 年 4 月 2 日起，reCAPTCHA 客户将成为客户数据的唯一数据控制方，Google 仅会根据 Google Cloud 服务条款 和 云端数据处理附录 处理您的 reCAPTCHA 客户数据。

reCAPTCHA Cookie (_grecaptcha) 仍然存在，并且不会受到影响。

Google 转变为数据处理方后，是否会对 reCAPTCHA 客户当前的 reCAPTCHA 实现或与 Google 的合同关系产生任何影响？

这不会对客户的 reCAPTCHA 实现或与 Google 的合同关系产生任何影响。也就是说，我们鼓励客户查看面向最终用户的隐私权披露，确保其中涵盖 reCAPTCHA 执行的处理目的，即安全、欺诈和滥用行为防范。reCAPTCHA 服务专用条款已更新，这是 reCAPTCHA 转变为数据处理方的一部分，但此次更新主要是移除客户的义务，例如向最终用户显示 Google 隐私权政策和 Google 服务条款的要求。

作为数据处理方，reCAPTCHA 处理的客户数据有哪些处理限制？

Google 承诺仅在提供和维护服务时处理使用 reCAPTCHA 捕获的客户数据，并确保服务的安全性、威胁检测、保护和响应能力能够有效应对不断演变的威胁。此目的限制已包含在当前的 reCAPTCHA 服务专用条款 中，并进一步基于我们在 云端数据处理附录 中作为数据处理方的义务。

reCAPTCHA 会收集哪些会话数据，Google 又如何保护这些数据？

如需了解 reCAPTCHA 收集的数据 以及 Google 采取的数据保护措施，请参阅 我们的 云端数据处理附录 和 reCAPTCHA 服务专用条款。

如需详细了解 Google 如何保护数据安全，请参阅安全白皮书。

reCAPTCHA 是否符合 GDPR 规定？

是的。在 Google Cloud，我们大力支持重视和提升客户个人数据安全性和隐私性的计划，同时希望 reCAPTCHA 客户根据 GDPR 要求放心使用我们的服务。我们在 云端数据处理附录 中承诺，对于 所有 Google Cloud 服务（包括 reCAPTCHA）中的客户个人数据，我们都会按照 GDPR 的规定进行处理。

如需了解 reCAPTCHA 的其他专用条款，请参阅 reCAPTCHA 服务专用条款。

reCAPTCHA 是否会收集支付交易信息？

当您在支付交易页面上安装 reCAPTCHA 时，它会检查某些交易信号，以帮助防范自动攻击。例如，在某些情况下，每秒多次尝试以相同的价格购买商品可能表明存在攻击。

不过，漫游器仅占整个欺诈问题的一小部分。如需 更全面地保护您的网站，请与 reCAPTCHA 欺诈防范功能集成， 以便发送更完整的交易信息，并接收 有关欺诈行为（例如银行卡测试和付款方式盗窃）的评估。

手势验证

以下部分介绍了手势验证的数据收集、权限和无障碍功能。

数据收集和存储

启用手势验证后，reCAPTCHA 会收集哪些数据？

  • Google 会分析用户执行各种操作或手势时的一个或多个手部视频。系统会对视频进行处理，以提取手部地标数据，其中包括 21 个指关节坐标 。
  • 视频绝不会与用户身份相关联，并且会在验证过程结束后删除。音频绝不会被录制。

启用手势验证后，reCAPTCHA 会存储哪些其他数据？

  • 验证流程结束后，Google 不会保留用户手势的任何图片或视频，也不会将这些数据用于任何其他目的。挑战完成后，视频或图片会自动删除。
  • Google 将按照 Google 隐私权政策 来使用和存储所收集的信息。

权限

了解手势验证的相机权限。

在用户同意的情况下，谁会获得相机权限？是 Google 还是第三方应用？

手势挑战需要访问用户相机的权限。在用户同意执行手势后，Google 会获得相机权限，用户可以随时在浏览器设置中管理权限。Google 处理手势视频的唯一目的是进行安全验证，不会将任何相关数据或权限转移给第三方。

无障碍问题

了解手势验证的无障碍功能。

对于存在无障碍问题的用户，手势验证如何运作？

对于存在无障碍问题而无法使用手势验证身份的用户，reCAPTCHA 将继续提供视觉和音频挑战，并开发新的、更易于访问且更安全的替代挑战。