Recibir códigos SMS de Google (Gmail y YouTube) en tu pipeline de pruebas

¿Cómo es el flujo de la API de códigos de verificación de Google?

El id de servicio es google y abarca Gmail, YouTube y el resto de la cuenta de Google. Las solicitudes van a https://otproute.com/api/v1 con una clave Bearer con prefijo or_live_.

1. Elige un id de país de GET /api/v1/countries, por ejemplo de o in.
2. Lee el precio en vivo con GET /api/v1/prices?country=de&service=google. Una ruta cerrada aparece aquí, antes de gastar nada.
3. Crea el pedido: POST /api/v1/activations con {"service": "google", "country": "de"}. Conserva el id de activación de la respuesta.
4. Introduce el número devuelto en el campo de teléfono de Google durante tu prueba.
5. Recibe el código mediante un webhook o consultando GET /api/v1/activations/{id}. Si la prueba se abandona, llama a POST /api/v1/activations/{id}/cancel.

Las cuentas disponen de hasta 10 claves de API y 300 solicitudes por minuto, y GET /api/v1/balance permite que una suite compruebe el saldo antes de empezar. La documentación de la API describe cada campo de la respuesta.

¿Cómo debe tratar un controlador de webhook los códigos de Google?

Suscribe uno de tus cinco endpoints de webhook a activation.sms_received, y también a activation.expired y activation.cancelled para que las tareas en espera puedan terminar limpiamente. Antes de fiarte de una solicitud, analiza X-OTPRoute-Signature (t=<unix>,v1=<hex>), recalcula HMAC-SHA256 sobre "<t>.<raw body>" con el secreto del endpoint, compáralo en tiempo constante y rechaza las marcas de tiempo fuera de una tolerancia corta.

Después haz que el controlador sea idempotente. Registra el id de activación la primera vez que proceses un evento e ignora las entregas posteriores del mismo. El polling sigue siendo un buen plan B para ejecuciones locales o agentes de CI tras un cortafuegos: consulta la activación cada pocos segundos hasta que informe del código o termine la ventana.

¿Cuándo pide Google un número de teléfono?

Google usa la verificación telefónica en varios momentos, y cuál aparece depende de la cuenta y de la situación:

• Registro: crear una cuenta de Google nueva puede incluir una comprobación telefónica, aunque es Google quien decide cuándo exigirla.
• Verificación en dos pasos: los códigos por SMS son una de las opciones de segundo factor para iniciar sesión.
• Recuperación de la cuenta: un teléfono de recuperación puede recibir un código cuando alguien queda bloqueado.
• Funciones de YouTube: algunas funciones del canal, como las subidas más largas y las miniaturas personalizadas, se desbloquean tras verificar un teléfono.

Esto importa al diseñar las pruebas. La verificación por SMS de Google para probar un paso de registro necesita un código, mientras que la verificación en dos pasos y la recuperación necesitan el mismo número otra vez más adelante. Un número de un solo uso sirve para el primer caso; los demás se tratan más abajo.

¿Qué países pueden recibir OTP de Google?

El servicio google está disponible actualmente en 199 países, entre ellos Estados Unidos, Alemania, India, Brasil, Indonesia, Nigeria, Reino Unido, Francia, México, Japón, Turquía, Egipto, Filipinas, Vietnam y Pakistán.

La elección del país no es cosmética. Google puede adaptar el idioma y los avisos de verificación a la región del número, así que haz coincidir el número con el mercado que representa tu cuenta de prueba. Una prueba de localización para un lanzamiento en Brasil debe usar un número brasileño, no la ruta que resulte más barata. Los precios difieren por país, y la página de precios explica cómo funcionan las tarifas en vivo.

¿Cómo obtienen un código de Google desde el panel quienes no son desarrolladores?

Inicia sesión, recarga el monedero con tarjeta o USDT/USDC y elige Google (Gmail y YouTube) y un país. El precio aparece antes de confirmar. Copia el número en el campo de teléfono de Google y mantén abierta la página de la activación; el código aparecerá allí cuando llegue el SMS.

Los agentes de soporte y los responsables de cuentas de agencias suelen usar este camino para preparar una única cuenta de prueba o de marca, mientras el equipo de ingeniería maneja el mismo monedero a través de la API. Cada recarga incluye una factura en PDF por correo electrónico y no hay cuota mensual.

¿Por qué puede Google no enviar un código y qué se puede hacer?

Cada activación tiene una ventana de 20 minutos y solo pagas si el código llega. Cuando la ventana se cierra vacía, o cancelas, el importe completo vuelve automáticamente a tu monedero.

Motivos por los que un código de Google no llega:

• Google puede rechazar un número virtual para la verificación en algunos flujos. Esa decisión es de Google, y el reembolso la cubre.
• La ruta puede estar ocupada en ese momento. Reintenta más tarde o con otro país que siga encajando con tu prueba.
• El envío puede ser simplemente lento. Deja correr la ventana antes de cancelar.

Evita repetir el pedido en un bucle rápido tras un fallo; espacia los intentos y registra el resultado por país para que tu suite aprenda qué rutas le convienen. Para CI, una cuenta de desarrollo puede pasarse a sandbox bajo petición, con números y códigos simulados para probar el propio arnés sin gastar saldo.

¿Cuándo es mejor un Número Dedicado para una cuenta de Google?

Un número de un solo uso sirve para un código. Si una cuenta de prueba de Google tiene que volver a iniciar sesión la semana próxima, pasar la verificación en dos pasos o usar la recuperación por teléfono, un número que desaparece tras un uso te dejará fuera. Para esos casos, un Número Virtual Dedicado en Estados Unidos o Canadá, desde $1.95/mes, se queda con la cuenta mientras se renueva y reenvía los SMS entrantes a tu webhook como number.sms_received. En cuentas de larga duración, valora pasar la verificación en dos pasos a una aplicación de autenticación una vez creada la cuenta.

El uso responsable importa aquí. Cumple las condiciones de Google, mantén una cuenta por persona o empresa reales y usa OTP Route solo para probar y operar tus propios productos y cuentas legítimos; se aplica su Política de Uso Aceptable. Google, Gmail y YouTube son marcas comerciales de Google LLC y OTP Route no tiene ninguna afiliación con Google.

Preguntas frecuentes

¿Puedo recibir por API un código de registro de Gmail?

Sí. Crea una activación con el servicio google y el país elegido, introduce el número en el formulario de registro y recoge el código desde un webhook o consultando la activación.

¿El mismo servicio `google` cubre YouTube?

Sí. YouTube funciona con cuentas de Google, así que las comprobaciones telefónicas de sus funciones usan el mismo id de servicio.

¿Cuánto cuesta un código de verificación de Google?

Desde $0.20 por código, según el país. El precio en vivo viene de GET /api/v1/prices, y no se cobra nada si el código no llega en 20 minutos.

¿Puedo usar un número de OTP Gateway para la verificación en dos pasos de Google?

No para inicios de sesión continuos, porque el número sirve para un único código. Usa un Número Dedicado de EE. UU. o Canadá, o una aplicación de autenticación, para las cuentas a las que volverás a entrar.

¿Por qué Google dijo que no se puede usar mi número?

Google decide qué números acepta y puede rechazar los virtuales. Cancela o deja que la activación caduque para obtener el reembolso automático, y prueba después más tarde u otro país adecuado.

¿Qué país debo elegir para una cuenta de prueba de Google?

Elige el mercado que representa la cuenta, para que el idioma y los avisos coincidan con lo que ven los usuarios reales de allí. Comprueba la disponibilidad en vivo de google con GET /api/v1/prices antes de pedir.

¿Hay un sandbox para probar el flujo de Google en CI?

Una cuenta de desarrollo puede pasarse a sandbox bajo petición. Devuelve números y códigos simulados, suficientes para probar la lógica de webhook y polling sin cargos al monedero.

Los nombres de los servicios son marcas registradas de sus respectivos propietarios. OTP Route no está afiliado a ellos. Usa los números de forma lícita y respeta las condiciones de cada servicio y nuestra Política de Uso Aceptable.