Получение SMS-кодов Google (Gmail и YouTube) в вашем тестовом конвейере

Как выглядит процесс получения кода Google через API?

Идентификатор сервиса — google, он охватывает Gmail, YouTube и весь аккаунт Google. Запросы отправляются на https://otproute.com/api/v1 с ключом Bearer с префиксом or_live_.

1. Выберите идентификатор страны из GET /api/v1/countries, например de или in.
2. Узнайте актуальную цену через GET /api/v1/prices?country=de&service=google. Закрытый маршрут виден уже здесь, до того как вы что-либо потратили.
3. Создайте заказ: POST /api/v1/activations с телом {"service": "google", "country": "de"}. Сохраните идентификатор активации из ответа.
4. Введите полученный номер в поле телефона Google в вашем тесте.
5. Получите код через вебхук или опросом GET /api/v1/activations/{id}. Если тест прерван, вызовите POST /api/v1/activations/{id}/cancel.

Аккаунту доступно до 10 ключей API и 300 запросов в минуту, а GET /api/v1/balance позволяет набору тестов проверить баланс до старта. Каждое поле ответа описано в документации API.

Как обработчик вебхука должен работать с кодами Google?

Подпишите один из пяти ваших эндпоинтов вебхуков на activation.sms_received, а также на activation.expired и activation.cancelled, чтобы ожидающие задачи могли корректно завершаться. Прежде чем доверять запросу, разберите X-OTPRoute-Signature (t=<unix>,v1=<hex>), пересчитайте HMAC-SHA256 от "<t>.<raw body>" с секретом эндпоинта, сравните за постоянное время и отклоняйте метки времени вне короткого допуска.

Затем сделайте обработчик идемпотентным. Записывайте идентификатор активации при первой обработке события и игнорируйте последующие доставки того же события. Опрос остаётся хорошим запасным вариантом для локальных запусков или CI-агентов за файрволом: запрашивайте активацию каждые несколько секунд, пока она не сообщит код или не закончится окно.

Когда Google просит номер телефона?

Google использует подтверждение по телефону в нескольких местах, и какое именно появится, зависит от аккаунта и ситуации:

• Регистрация: при создании нового аккаунта Google может проверять телефон, хотя сам решает, когда это требовать.
• Двухэтапная аутентификация: SMS-коды — один из вариантов второго фактора при входе.
• Восстановление аккаунта: на резервный телефон может прийти код, если доступ заблокирован.
• Функции YouTube: некоторые возможности канала, например более длинные видео и пользовательские обложки, открываются после подтверждения телефона.

Это важно при проектировании тестов. SMS-подтверждение Google для теста шага регистрации требует одного кода, а двухэтапной аутентификации и восстановлению позже снова нужен тот же номер. Первому случаю подходит одноразовый номер; остальные разобраны ниже.

В каких странах можно получать OTP Google?

Сервис google сейчас доступен в 199 странах, включая США, Германию, Индию, Бразилию, Индонезию, Нигерию, Великобританию, Францию, Мексику, Японию, Турцию, Египет, Филиппины, Вьетнам и Пакистан.

Выбор страны — не формальность. Google может подстраивать язык и запросы подтверждения под регион номера, поэтому подбирайте номер под рынок, который представляет тестовый аккаунт. Локализационный прогон для запуска в Бразилии должен использовать бразильский номер, а не самый дешёвый маршрут. Цены различаются по странам, а как работают актуальные тарифы, объясняет страница цен.

Как получить код Google из панели тем, кто не разработчик?

Войдите, пополните кошелёк картой или в USDT/USDC, затем выберите Google (Gmail и YouTube) и страну. Цена показывается до подтверждения. Скопируйте номер в поле телефона Google и держите страницу активации открытой: код появится там, когда придёт SMS.

Сотрудники поддержки и аккаунт-менеджеры агентств часто выбирают этот путь, настраивая один тестовый или брендовый аккаунт, а инженерная команда работает с тем же кошельком через API. К каждому пополнению по электронной почте приходит PDF-счёт, ежемесячной платы нет.

Почему Google может не прислать код и что делать?

У каждой активации 20-минутное окно, и вы платите, только если код пришёл. Если окно закрылось пустым или вы отменили активацию, вся сумма автоматически возвращается на кошелёк.

Почему код Google может не дойти:

• В некоторых сценариях Google может отказать виртуальному номеру. Это решение Google, и возврат это покрывает.
• Маршрут может быть занят в этот момент. Повторите позже или выберите другую страну, которая всё ещё подходит вашему тесту.
• Отправка может просто идти медленно. Дождитесь конца окна, прежде чем отменять.

Не заказывайте заново в плотном цикле после неудачи; разносите попытки по времени и фиксируйте результат по странам, чтобы ваш набор тестов узнал, какие маршруты ему подходят. Для CI тестовый аккаунт по запросу можно перевести в sandbox: он возвращает симулированные номера и коды, так что саму обвязку можно проверить без трат с кошелька.

Когда Dedicated Number лучше подходит для аккаунта Google?

Одноразовый номер работает для одного кода. Если тестовому аккаунту Google на следующей неделе нужно снова войти, пройти двухэтапную аутентификацию или воспользоваться восстановлением по телефону, номер, исчезающий после одного использования, закроет вам доступ. В таких случаях Dedicated Virtual Number в США или Канаде, от $1.95/месяц, остаётся за аккаунтом, пока продлевается, и пересылает входящие SMS на ваш вебхук как number.sms_received. Для долгоживущих аккаунтов подумайте о переносе двухэтапной аутентификации в приложение-аутентификатор после создания аккаунта.

Здесь важно ответственное использование. Соблюдайте условия Google, держите один аккаунт на реального человека или компанию и применяйте OTP Route только для тестирования и работы ваших собственных законных продуктов и аккаунтов; действует его политика допустимого использования. Google, Gmail и YouTube — товарные знаки Google LLC, и OTP Route не связан с Google.

Частые вопросы

Можно ли получить код регистрации Gmail через API?

Да. Создайте активацию с сервисом google и выбранной страной, введите номер в форму регистрации и заберите код с вебхука или опросом активации.

Охватывает ли тот же сервис `google` и YouTube?

Да. YouTube работает на аккаунтах Google, поэтому проверки телефона для функций YouTube используют тот же идентификатор сервиса.

Сколько стоит код подтверждения Google?

От $0.20 за код, в зависимости от страны. Актуальная цена берётся из GET /api/v1/prices, и ничего не списывается, если код не пришёл в течение 20 минут.

Можно ли использовать номер OTP Gateway для двухэтапной аутентификации Google?

Для постоянных входов нет, потому что номер обслуживает один код. Для аккаунтов, в которые вы будете входить снова, используйте Dedicated Number в США или Канаде либо приложение-аутентификатор.

Почему Google сообщил, что мой номер нельзя использовать?

Google сам решает, какие номера принимать, и может отклонять виртуальные. Отмените активацию или дождитесь её истечения для автоматического возврата, затем попробуйте позже или в другой подходящей стране.

Какую страну выбрать для тестового аккаунта Google?

Выберите рынок, который представляет аккаунт, чтобы язык и запросы совпадали с тем, что видят реальные пользователи там. Перед заказом проверьте актуальную доступность google через GET /api/v1/prices.

Есть ли sandbox для тестирования процесса Google в CI?

Тестовый аккаунт можно перевести в sandbox по запросу. Он возвращает симулированные номера и коды — этого достаточно, чтобы проверить логику вебхуков и опроса без списаний с кошелька.

Названия сервисов являются товарными знаками их владельцев. OTP Route не связан с ними. Используйте номера законно, соблюдайте условия каждого сервиса и нашу Политику допустимого использования.