在测试流水线中接收 Google（Gmail 与 YouTube）短信验证码

Google 验证码 API 的流程是怎样的？

服务 id 是 google，它涵盖 Gmail、YouTube 以及更广泛的 Google 账号。请求发送至 https://otproute.com/api/v1，使用带 or_live_ 前缀的 Bearer 密钥。

1. 从 GET /api/v1/countries 中选择一个国家 id，例如 de 或 in。
2. 用 GET /api/v1/prices?country=de&service=google 读取实时价格。线路关闭的情况会在这里显示，此时你还没有花任何钱。
3. 创建订单：以 {"service": "google", "country": "de"} 调用 POST /api/v1/activations，保留响应中的 activation id。
4. 在测试中，把返回的号码输入 Google 的手机号提示框。
5. 通过 Webhook 或轮询 GET /api/v1/activations/{id} 接收验证码。如果测试被放弃，调用 POST /api/v1/activations/{id}/cancel。

每个账号最多可有 10 个 API 密钥，每分钟 300 次请求，测试套件还可以在开始前用 GET /api/v1/balance 检查余额。各响应字段在 API 文档中有说明。

Webhook 处理程序应如何处理 Google 验证码？

将你的五个 Webhook 端点之一订阅到 activation.sms_received，同时订阅 activation.expired 和 activation.cancelled，让等待中的任务能够干净地退出。在信任请求之前，先解析 X-OTPRoute-Signature（t=<unix>,v1=<hex>），用端点密钥对 "<t>.<raw body>" 重新计算 HMAC-SHA256，以常量时间比较，并拒绝超出较小容差范围的时间戳。

然后让处理程序具备幂等性：第一次处理某个事件时记录 activation id，之后对同一事件的重复投递一律忽略。对于本地运行或位于防火墙后的 CI 代理，轮询仍是不错的备选：每隔几秒查询一次激活，直到它返回验证码或有效期结束。

Google 什么时候会要求提供手机号？

Google 会在多个环节使用手机验证，具体出现哪一种取决于账号和情形：

• 注册：创建新的 Google 账号可能包含手机号检查，不过何时要求由 Google 决定。
• 两步验证：短信验证码是登录时第二重验证的选项之一。
• 账号恢复：账号被锁定时，恢复手机号可以接收验证码。
• YouTube 功能：某些频道功能，例如更长时间的上传和自定义缩略图，需要验证手机号后才能解锁。

这对测试设计很重要。测试注册这一步的 Google 短信验证只需要一个验证码，而两步验证和账号恢复之后还会再次用到同一个号码。一次性号码适合第一种情况，其余情况见后文。

哪些国家可以接收 Google 验证码？

google 服务目前在 199 个国家可用，包括美国、德国、印度、巴西、印度尼西亚、尼日利亚，以及英国、法国、墨西哥、日本、土耳其、埃及、菲律宾、越南和巴基斯坦。

选择国家并不只是表面功夫。Google 可能会根据号码所在地区调整语言和验证提示，所以请让号码与测试账号所代表的市场相匹配。为巴西发布做本地化测试，就应使用巴西号码，而不是挑最便宜的线路。各国价格不同，价格页面说明了实时费率的运作方式。

非开发者如何在控制台中获取 Google 验证码？

登录后，用银行卡或 USDT/USDC 为钱包充值，然后选择 Google（Gmail 与 YouTube）和国家。确认前会先显示价格。把号码复制到 Google 的手机号输入框，并保持激活页面打开；短信到达后，验证码会出现在那里。

客服人员和代理机构的客户经理在设置单个测试账号或品牌账号时，常用这种方式，而工程团队则通过 API 使用同一个钱包。每次充值都会通过邮件附上 PDF 发票，且没有月费。

Google 为什么可能没有发送验证码？该怎么办？

每次激活都有 20 分钟的有效期，只有验证码送达才收费。如果有效期结束时仍没有收到，或者你取消了激活，全额金额会自动退回钱包。

Google 验证码收不到的几种原因：

• 在某些流程中，Google 可能拒绝用虚拟号码进行验证。这一决定由 Google 做出，退款会覆盖这种情况。
• 线路在那一刻可能繁忙。稍后重试，或换一个仍符合测试需要的国家。
• 发送也可能只是比较慢。取消之前，先让有效期走完。

没收到后不要在紧凑的循环里反复下单；请拉开尝试的间隔，并按国家记录结果，让你的测试套件逐渐了解哪些线路适合自己。对于 CI，可以应要求把开发账号切换到沙盒，它会返回模拟的号码和验证码，这样无需消耗钱包资金，就能测试测试框架本身。

Google 账号什么时候更适合使用专属号码？

一次性号码只能用于一个验证码。如果某个 Google 测试账号下周还要再次登录、通过两步验证或使用手机恢复，用完一次就消失的号码会把你锁在门外。这些情况下，美国或加拿大的专属虚拟号码（每月 $1.95 起）会在续费期间一直跟随该账号，并将收到的短信以 number.sms_received 转发到你的 Webhook。对于长期使用的账号，账号建好之后可以考虑把两步验证改用身份验证器应用。

负责任地使用同样重要。请遵守 Google 的条款，每个真实的人或企业只对应一个账号，并且只把 OTP Route 用于测试和运营你自己的合法产品与账号；其《可接受使用政策》同样适用。Google、Gmail 和 YouTube 是 Google LLC 的商标，OTP Route 与 Google 没有任何关联。

常见问题

能通过 API 接收 Gmail 注册验证码吗？

可以。用服务 google 和你选定的国家创建激活，把号码填入注册表单，然后通过 Webhook 或轮询激活来获取验证码。

同一个 `google` 服务也涵盖 YouTube 吗？

是的。YouTube 运行在 Google 账号之上，因此 YouTube 功能的手机号检查使用同一个服务 id。

一个 Google 验证码要多少钱？

每个验证码 $0.20 起，因国家而异。实时价格来自 GET /api/v1/prices，如果 20 分钟内验证码没有到达，则不会扣费。

OTP Gateway 号码能用于 Google 两步验证吗？

不适合用于后续登录，因为该号码只对应一个验证码。对于之后还要登录的账号，请使用美国或加拿大的专属号码，或使用身份验证器应用。

为什么 Google 提示我的号码不能使用？

Google 自行决定接受哪些号码，可能拒绝虚拟号码。取消或让激活过期即可自动退款，然后稍后再试，或换一个合适的国家。

Google 测试账号应该选哪个国家？

选择该账号所代表的市场，让语言和提示与当地真实用户看到的一致。下单前，用 GET /api/v1/prices 查看 google 的实时可用情况。

CI 中有沙盒可以测试 Google 流程吗？

可以应要求将开发账号切换到沙盒。它返回模拟的号码和验证码，足以在不扣钱包余额的情况下测试 Webhook 和轮询逻辑。

服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。