Recevoir les codes SMS Google (Gmail et YouTube) dans votre pipeline de test

À quoi ressemble le flux de l'API de code de vérification Google ?

L'identifiant de service est google, et il couvre Gmail, YouTube et l'ensemble du compte Google. Les requêtes vont vers https://otproute.com/api/v1 avec une clé Bearer préfixée or_live_.

1. Choisissez un identifiant de pays dans GET /api/v1/countries, par exemple de ou in.
2. Lisez le prix en direct avec GET /api/v1/prices?country=de&service=google. Une route fermée apparaît ici, avant que vous ne dépensiez quoi que ce soit.
3. Créez la commande : POST /api/v1/activations avec {"service": "google", "country": "de"}. Conservez l'identifiant d'activation renvoyé.
4. Saisissez le numéro obtenu dans le champ de téléphone de Google, dans votre test.
5. Recevez le code par webhook ou en interrogeant GET /api/v1/activations/{id}. Si le test est abandonné, appelez POST /api/v1/activations/{id}/cancel.

Les comptes disposent de 10 clés API au maximum et de 300 requêtes par minute, et GET /api/v1/balance permet à une suite de tests de vérifier les fonds avant de démarrer. La documentation de l'API décrit chaque champ de réponse.

Comment un gestionnaire de webhook doit-il traiter les codes Google ?

Abonnez l'un de vos cinq endpoints de webhook à activation.sms_received, ainsi qu'à activation.expired et activation.cancelled, afin que les tâches en attente puissent se terminer proprement. Avant de faire confiance à une requête, analysez X-OTPRoute-Signature (t=<unix>,v1=<hex>), recalculez un HMAC-SHA256 sur "<t>.<raw body>" avec le secret du endpoint, comparez-le en temps constant et rejetez les horodatages situés hors d'une courte tolérance.

Rendez ensuite le gestionnaire idempotent. Enregistrez l'identifiant d'activation la première fois que vous traitez un événement et ignorez les livraisons ultérieures du même événement. L'interrogation reste un bon repli pour les exécutions locales ou les agents CI derrière un pare-feu : interrogez l'activation toutes les quelques secondes jusqu'à ce qu'elle indique le code ou que la fenêtre se termine.

Quand Google demande-t-il un numéro de téléphone ?

Google utilise la vérification par téléphone à plusieurs moments, et le moment dépend du compte et de la situation :

• Inscription : la création d'un nouveau compte Google peut inclure une vérification par téléphone, mais c'est Google qui décide quand l'exiger.
• Validation en deux étapes : les codes SMS font partie des seconds facteurs possibles pour se connecter.
• Récupération de compte : un téléphone de récupération peut recevoir un code lorsque quelqu'un est bloqué hors de son compte.
• Fonctionnalités YouTube : certaines fonctionnalités de chaîne, comme les vidéos plus longues et les miniatures personnalisées, se débloquent une fois le téléphone vérifié.

Cela compte pour la conception des tests. Un test d'inscription avec vérification SMS Google n'a besoin que d'un code, tandis que la validation en deux étapes et la récupération exigent plus tard le même numéro. Un numéro à usage unique convient au premier cas ; les autres sont traités plus bas.

Dans quels pays peut-on recevoir des codes OTP Google ?

Le service google est actuellement disponible dans 199 pays, dont les États-Unis, l'Allemagne, l'Inde, le Brésil, l'Indonésie, le Nigeria, le Royaume-Uni, la France, le Mexique, le Japon, la Turquie, l'Égypte, les Philippines, le Vietnam et le Pakistan.

Le choix du pays n'a rien de cosmétique. Google peut adapter la langue et les invites de vérification à la région du numéro ; faites donc correspondre le numéro au marché que représente votre compte de test. Un test de localisation pour un lancement au Brésil doit utiliser un numéro brésilien, pas la route la moins chère. Les prix varient selon le pays, et la page des tarifs explique le fonctionnement des tarifs en direct.

Comment les non-développeurs obtiennent-ils un code Google depuis le tableau de bord ?

Connectez-vous, rechargez le portefeuille par carte ou en USDT/USDC, puis choisissez Google (Gmail et YouTube) et un pays. Le prix s'affiche avant la confirmation. Copiez le numéro dans le champ de téléphone de Google et gardez la page d'activation ouverte ; le code y apparaît dès l'arrivée du SMS.

Les agents de support et les responsables de comptes en agence empruntent souvent cette voie pour configurer un compte de test ou de marque isolé, pendant que l'équipe d'ingénierie pilote le même portefeuille par l'API. Chaque rechargement donne lieu à une facture PDF par e-mail, et il n'y a pas d'abonnement mensuel.

Pourquoi Google peut-il ne pas envoyer de code, et que faire ?

Chaque activation a une fenêtre de 20 minutes, et vous ne payez que si le code arrive. Lorsque la fenêtre se ferme à vide, ou si vous annulez, la totalité du montant retourne automatiquement dans votre portefeuille.

Raisons pour lesquelles un code Google n'arrive pas :

• Google peut refuser un numéro virtuel pour la vérification dans certains parcours. Cette décision revient à Google, et le remboursement la couvre.
• La route peut être saturée à ce moment-là. Réessayez plus tard ou avec un autre pays qui convient encore à votre test.
• L'envoi peut simplement être lent. Laissez la fenêtre aller au bout avant d'annuler.

Évitez de recommander en boucle serrée après un échec ; espacez les tentatives et consignez le résultat par pays pour que votre suite apprenne quelles routes lui conviennent. En CI, un compte de développement peut être passé en sandbox sur demande, avec des numéros et des codes simulés pour tester le dispositif lui-même sans dépenser de fonds.

Quand un Numéro dédié convient-il mieux pour un compte Google ?

Un numéro à usage unique fonctionne pour un seul code. Si un compte Google de test doit se reconnecter la semaine prochaine, passer la validation en deux étapes ou utiliser la récupération par téléphone, un numéro qui disparaît après un usage vous bloquera. Dans ces cas, un Numéro virtuel dédié aux États-Unis ou au Canada, à partir de $1.95/mois, reste attaché au compte tant qu'il se renouvelle et transmet les SMS entrants à votre webhook sous la forme number.sms_received. Pour les comptes durables, envisagez de passer la validation en deux étapes à une application d'authentification une fois le compte créé.

L'usage responsable compte ici. Respectez les conditions de Google, limitez-vous à un compte par personne réelle ou par entreprise, et n'utilisez OTP Route que pour tester et exploiter vos propres produits et comptes légitimes ; sa politique d'utilisation acceptable s'applique. Google, Gmail et YouTube sont des marques de Google LLC, et OTP Route n'a aucune affiliation avec Google.

Questions fréquentes

Puis-je recevoir un code d'inscription Gmail via une API ?

Oui. Créez une activation avec le service google et le pays choisi, saisissez le numéro dans le formulaire d'inscription, puis récupérez le code par webhook ou en interrogeant l'activation.

Le même service `google` couvre-t-il YouTube ?

Oui. YouTube repose sur les comptes Google ; les vérifications par téléphone pour les fonctionnalités YouTube utilisent donc le même identifiant de service.

Combien coûte un code de vérification Google ?

À partir de $0.20 par code, selon le pays. Le prix en direct vient de GET /api/v1/prices, et rien n'est facturé si le code n'arrive pas dans les 20 minutes.

Puis-je utiliser un numéro OTP Gateway pour la validation en deux étapes de Google ?

Pas pour des connexions récurrentes, car le numéro ne sert que pour un seul code. Utilisez un Numéro dédié américain ou canadien, ou une application d'authentification, pour les comptes auxquels vous vous reconnecterez.

Pourquoi Google a-t-il dit que mon numéro ne peut pas être utilisé ?

Google décide des numéros qu'il accepte et peut refuser les numéros virtuels. Annulez ou laissez l'activation expirer pour un remboursement automatique, puis réessayez plus tard ou avec un autre pays adapté.

Quel pays choisir pour un compte Google de test ?

Choisissez le marché que représente le compte, pour que la langue et les invites correspondent à ce que voient les vrais utilisateurs de ce marché. Vérifiez la disponibilité en direct de google avec GET /api/v1/prices avant de commander.

Existe-t-il un sandbox pour tester le parcours Google en CI ?

Un compte de développement peut être passé en sandbox sur demande. Il renvoie des numéros et des codes simulés, suffisants pour tester la logique de webhook et d'interrogation sans frais sur le portefeuille.

Les noms de services sont des marques déposées de leurs propriétaires respectifs. OTP Route n'est affilié à aucun d'entre eux. Utilisez les numéros de manière licite et respectez les conditions de chaque service ainsi que notre Politique d'utilisation acceptable.