Receber códigos SMS do Google (Gmail e YouTube) no seu pipeline de testes

Como é o fluxo da API de código de verificação do Google?

O id do serviço é google, e ele cobre o Gmail, o YouTube e a conta Google como um todo. As requisições vão para https://otproute.com/api/v1 com uma chave Bearer de prefixo or_live_.

1. Escolha um id de país em GET /api/v1/countries, por exemplo de ou in.
2. Leia o preço atual com GET /api/v1/prices?country=de&service=google. Uma rota fechada aparece aqui, antes de você gastar qualquer coisa.
3. Crie o pedido: POST /api/v1/activations com {"service": "google", "country": "de"}. Guarde o id da ativação que vem na resposta.
4. Digite o número retornado no campo de telefone do Google durante o teste.
5. Receba o código por webhook ou consultando GET /api/v1/activations/{id}. Se o teste for abandonado, chame POST /api/v1/activations/{id}/cancel.

As contas têm até 10 chaves de API e 300 requisições por minuto, e GET /api/v1/balance permite que uma suíte de testes confira o saldo antes de começar. A documentação da API descreve cada campo das respostas.

Como um handler de webhook deve tratar os códigos do Google?

Assine activation.sms_received em um dos seus cinco endpoints de webhook, e também activation.expired e activation.cancelled, para que os jobs em espera possam terminar de forma limpa. Antes de confiar em uma requisição, leia X-OTPRoute-Signature (t=<unix>,v1=<hex>), recalcule o HMAC-SHA256 de "<t>.<raw body>" com o segredo do endpoint, compare em tempo constante e rejeite timestamps fora de uma tolerância curta.

Depois, torne o handler idempotente. Registre o id da ativação na primeira vez que processar um evento e ignore as entregas seguintes do mesmo evento. A consulta periódica continua sendo um bom plano B para execuções locais ou agentes de CI atrás de firewall: consulte a ativação a cada poucos segundos até que ela informe o código ou a janela termine.

Quando o Google pede um número de telefone?

O Google usa a verificação por telefone em vários pontos, e qual deles aparece depende da conta e da situação:

• Cadastro: criar uma nova conta Google pode incluir uma verificação por telefone, embora o Google decida quando exigi-la.
• Verificação em duas etapas: os códigos por SMS são uma das opções de segundo fator para entrar.
• Recuperação de conta: um telefone de recuperação pode receber um código quando alguém fica sem acesso.
• Recursos do YouTube: alguns recursos de canal, como uploads mais longos e miniaturas personalizadas, são liberados depois que um telefone é verificado.

Isso importa para o desenho dos testes. A verificação por SMS do Google para testar uma etapa de cadastro precisa de um único código, enquanto a verificação em duas etapas e a recuperação precisam do mesmo número de novo mais tarde. Um número de uso único serve para o primeiro caso; os outros são tratados mais adiante.

Quais países podem receber OTPs do Google?

O serviço google está disponível hoje em 199 países, entre eles Estados Unidos, Alemanha, Índia, Brasil, Indonésia, Nigéria, Reino Unido, França, México, Japão, Turquia, Egito, Filipinas, Vietnã e Paquistão.

A escolha do país não é cosmética. O Google pode adaptar o idioma e as mensagens de verificação à região do número, então combine o número com o mercado que a sua conta de teste representa. Um teste de localização para um lançamento no Brasil deve usar um número brasileiro, e não a rota que por acaso for mais barata. Os preços variam por país, e a página de preços explica como funcionam as tarifas ao vivo.

Como quem não é desenvolvedor obtém um código do Google pelo painel?

Entre na conta, recarregue a carteira por cartão ou USDT/USDC e escolha Google (Gmail e YouTube) e um país. O preço aparece antes de você confirmar. Copie o número para o campo de telefone do Google e mantenha a página da ativação aberta; o código aparece ali quando o SMS chegar.

Agentes de suporte e gerentes de contas de agências costumam usar esse caminho para configurar um único teste ou uma conta de marca, enquanto a equipe de engenharia aciona a mesma carteira pela API. Cada recarga vem com uma fatura em PDF por e-mail, e não há mensalidade.

Por que o Google pode não enviar um código, e o que fazer?

Cada ativação tem uma janela de 20 minutos, e você só paga se o código chegar. Quando a janela termina vazia, ou você cancela, o valor integral volta para a sua carteira automaticamente.

Motivos para um código do Google não chegar:

• O Google pode recusar um número virtual em alguns fluxos de verificação. Essa decisão é do Google, e o reembolso cobre esse caso.
• A rota pode estar ocupada naquele momento. Tente de novo mais tarde ou com outro país que ainda sirva ao seu teste.
• O envio pode simplesmente estar lento. Deixe a janela correr antes de cancelar.

Evite refazer o pedido em laço rápido depois de uma falha; espace as tentativas e registre o resultado por país para que a sua suíte aprenda quais rotas funcionam melhor. Para CI, uma conta de desenvolvimento pode ser colocada em sandbox mediante pedido, retornando números e códigos simulados para que o próprio harness seja testado sem gastar saldo.

Quando um Número Dedicado é mais adequado para uma conta Google?

Um número de uso único serve para um código. Se uma conta de teste do Google precisar entrar de novo na semana que vem, passar pela verificação em duas etapas ou usar a recuperação por telefone, um número que desaparece depois de um uso deixará você sem acesso. Nesses casos, um Número Virtual Dedicado nos Estados Unidos ou no Canadá, a partir de $1.95/mês, permanece com a conta enquanto renova e encaminha os SMS recebidos ao seu webhook como number.sms_received. Para contas de longa duração, considere migrar a verificação em duas etapas para um aplicativo autenticador depois que a conta existir.

O uso responsável importa aqui. Siga os termos do Google, mantenha uma conta por pessoa ou empresa real e use a OTP Route apenas para testar e operar seus próprios produtos e contas legítimos; a Política de Uso Aceitável se aplica. Google, Gmail e YouTube são marcas registradas da Google LLC, e a OTP Route não tem afiliação com o Google.

Perguntas frequentes

Posso receber um código de cadastro do Gmail por uma API?

Sim. Crie uma ativação com o serviço google e o país escolhido, digite o número no formulário de cadastro e obtenha o código por webhook ou consultando a ativação.

O mesmo serviço `google` cobre o YouTube?

Sim. O YouTube funciona com contas Google, então as verificações por telefone de recursos do YouTube usam o mesmo id de serviço.

Quanto custa um código de verificação do Google?

A partir de $0.20 por código, dependendo do país. O preço atual vem de GET /api/v1/prices, e nada é cobrado se o código não chegar em 20 minutos.

Posso usar um número do OTP Gateway para a verificação em duas etapas do Google?

Não para logins recorrentes, porque o número atende a um único código. Use um Número Dedicado dos EUA ou do Canadá, ou um aplicativo autenticador, para contas em que você vai entrar de novo.

Por que o Google disse que meu número não pode ser usado?

O Google decide quais números aceita e pode recusar os virtuais. Cancele ou deixe a ativação expirar para receber o reembolso automático e tente depois, ou em outro país adequado.

Qual país devo escolher para uma conta de teste do Google?

Escolha o mercado que a conta representa, para que o idioma e as mensagens correspondam ao que os usuários reais de lá veem. Confira a disponibilidade atual de google com GET /api/v1/prices antes de pedir.

Existe um sandbox para testar o fluxo do Google em CI?

Uma conta de desenvolvimento pode ser colocada em sandbox mediante pedido. Ela retorna números e códigos simulados, suficientes para testar a lógica de webhook e de consulta periódica sem cobranças na carteira.

Os nomes dos serviços são marcas registradas de seus respectivos proprietários. A OTP Route não é afiliada a eles. Use os números de forma lícita e siga os termos de cada serviço e nossa Política de Uso Aceitável.