テストパイプラインで Google（Gmail・YouTube）の SMS コードを受け取る

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. 注文を作成します。POST /api/v1/activations に {"service": "google", "country": "de"} を送り、レスポンスのアクティベーション ID を保持します。
4. 返された番号を、テスト内で Google の電話番号入力欄に入力します。
5. Webhook またはポーリング（GET /api/v1/activations/{id}）でコードを受け取ります。テストを取りやめる場合は POST /api/v1/activations/{id}/cancel を呼び出します。

アカウントごとに最大 10 個の API キーと 1 分あたり 300 リクエストが利用でき、GET /api/v1/balance でテストスイートが開始前に残高を確認できます。各レスポンスフィールドは API ドキュメントで説明しています。

Webhook ハンドラーは Google のコードをどう扱うべきか？

5 つある Webhook エンドポイントの一つで activation.sms_received を購読し、待機中のジョブがきれいに終了できるよう activation.expired と activation.cancelled も購読します。リクエストを信頼する前に X-OTPRoute-Signature（t=<unix>,v1=<hex>）を解析し、エンドポイントのシークレットで "<t>.<raw body>" の HMAC-SHA256 を再計算して、定数時間で比較し、短い許容範囲外のタイムスタンプを拒否します。

次に、ハンドラーを冪等にします。イベントを初めて処理したときにアクティベーション ID を記録し、同じイベントの以降の配信は無視します。ローカル実行やファイアウォール内の CI エージェントでは、ポーリングが引き続き有効な代替手段です。コードが返るか有効時間が終わるまで、数秒おきにアクティベーションを照会します。

Google はいつ電話番号を求めるのか？

Google はいくつかの場面で電話認証を使い、どれが表示されるかはアカウントや状況によって変わります。

• 新規登録: 新しい Google アカウントの作成時に電話確認が入ることがありますが、必要かどうかは Google が決めます。
• 2 段階認証: SMS コードはサインイン時の第 2 要素の選択肢の一つです。
• アカウント復旧: ロックアウトされたときに、復旧用の電話番号へコードが届くことがあります。
• YouTube の機能: 長い動画のアップロードやカスタムサムネイルなど、一部のチャンネル機能は電話番号の認証後に利用できるようになります。

テスト設計ではここが重要です。登録ステップの Google SMS 認証テストに必要なコードは 1 つですが、2 段階認証と復旧では後から同じ番号がもう一度必要になります。1 回限りの番号は前者に向いており、後者については後半で説明します。

Google の OTP を受信できるのはどの国か？

google サービスは現在 199 か国で利用でき、米国、ドイツ、インド、ブラジル、インドネシア、ナイジェリアのほか、英国、フランス、メキシコ、日本、トルコ、エジプト、フィリピン、ベトナム、パキスタンなどが含まれます。

国の選択は見た目だけの問題ではありません。Google は番号の地域に応じて言語や認証プロンプトを変えることがあるため、テストアカウントが表す市場に番号を合わせてください。ブラジルでのローンチに向けたローカライズ検証には、いちばん安いルートではなくブラジルの番号を使うべきです。料金は国ごとに異なり、リアルタイムの料金の仕組みは料金ページで説明しています。

開発者でなくてもダッシュボードから Google のコードを取得できるか？

サインインして、カードまたは USDT/USDC でウォレットにチャージし、Google（Gmail・YouTube）と国を選びます。確定する前に料金が表示されます。番号を Google の電話番号欄にコピーし、アクティベーションのページを開いたままにしておくと、SMS が届いた時点でコードがそこに表示されます。

サポート担当やエージェンシーのアカウントマネージャーは、単発のテストアカウントやブランド用アカウントを設定するときによくこの方法を使い、エンジニアリングチームは同じウォレットを API から操作します。チャージのたびに PDF の請求書がメールで届き、月額料金はありません。

Google がコードを送らない理由と対処法は？

各アクティベーションには 20 分の有効時間があり、コードが届いた場合にのみ課金されます。何も届かないまま時間が終わった場合、またはキャンセルした場合は、全額が自動的にウォレットに戻ります。

Google のコードが届かない主な理由は次のとおりです。

• Google が、一部のフローで Google 認証に仮想番号を拒否することがあります。その判断は Google にあり、返金で対応されます。
• そのときルートが混み合っている可能性があります。時間をおくか、テストに合う別の国で再試行してください。
• 送信が単に遅れていることもあります。キャンセルする前に有効時間を使い切ってください。

失敗の後に短い間隔で連続注文するのは避け、試行の間隔を空けて、国ごとの結果を記録しておくと、スイートがどのルートに合うか学べます。CI では、リクエストにより開発アカウントをサンドボックスに切り替えられ、模擬の番号とコードが返るので、ウォレットの費用をかけずにテストハーネス自体を検証できます。

Google アカウントで専用番号のほうが向いているのはいつか？

1 回限りの番号が使えるのは 1 つのコードだけです。Google のテストアカウントが来週もう一度サインインする、2 段階認証を通す、電話による復旧を使うといった場合、一度使うと消える番号ではロックアウトされてしまいます。そのようなときは、米国またはカナダの専用仮想番号（Dedicated Virtual Number）が向いています。$1.95/月 からで、更新されている間はアカウントに紐づいたままとなり、受信 SMS を number.sms_received として Webhook に転送します。長期間使うアカウントでは、アカウントを作成した後に 2 段階認証を認証アプリへ移すことも検討してください。

ここでは責任ある利用が重要です。Google の利用規約に従い、実在する一人の個人または一つの事業につき 1 アカウントにとどめ、OTP Route はご自身の正当なプロダクトとアカウントのテストと運用にのみ使ってください。利用規定（Acceptable Use Policy）が適用されます。Google、Gmail、YouTube は Google LLC の商標であり、OTP Route は Google と提携していません。

よくある質問

API で Gmail の登録コードを受信できますか？

はい。サービスに google と希望の国を指定してアクティベーションを作成し、登録フォームに番号を入力して、Webhook またはアクティベーションのポーリングでコードを取得します。

同じ `google` サービスで YouTube にも対応しますか？

はい。YouTube は Google アカウントで動いているため、YouTube の機能に必要な電話確認にも同じサービス ID を使います。

Google の認証コードの料金はいくらですか？

国によって異なりますが、1 コード $0.20 からです。最新の価格は GET /api/v1/prices で確認でき、20 分以内にコードが届かなければ課金されません。

Google の 2 段階認証に OTP Gateway の番号を使えますか？

継続的なサインインには向きません。番号は 1 つのコード専用だからです。再びログインするアカウントには、米国またはカナダの専用番号か、認証アプリを使ってください。

Google に「この番号は使用できません」と表示されたのはなぜですか？

Google がどの番号を受け付けるかを決めており、仮想番号を断ることがあります。キャンセルするか有効時間の終了を待てば自動的に返金されるので、その後で時間をおくか、別の適した国で再試行してください。

Google のテストアカウントにはどの国を選べばよいですか？

アカウントが表す市場を選ぶと、言語やプロンプトがその地域の実ユーザーと同じになります。注文前に GET /api/v1/prices で google の最新の提供状況を確認してください。

CI で Google のフローをテストするサンドボックスはありますか？

リクエストにより開発アカウントをサンドボックスに切り替えられます。模擬の番号とコードが返されるので、ウォレットの課金なしに Webhook とポーリングのロジックを検証できます。

サービス名はそれぞれの所有者の商標です。OTP Route はこれらの企業と提携していません。番号は合法的にご利用いただき、各サービスの利用規約および当社の利用規定に従ってください。