Odbieranie kodów SMS Google (Gmail i YouTube) w potoku testowym

Jak wygląda przepływ kodu weryfikacyjnego Google przez API?

Identyfikator usługi to google i obejmuje on Gmail, YouTube oraz całe konto Google. Żądania trafiają na https://otproute.com/api/v1 z kluczem Bearer z prefiksem or_live_.

1. Wybierz identyfikator kraju z GET /api/v1/countries, na przykład de lub in.
2. Odczytaj aktualną cenę przez GET /api/v1/prices?country=de&service=google. Zamknięta trasa pojawi się tutaj, zanim cokolwiek wydasz.
3. Utwórz zamówienie: POST /api/v1/activations z treścią {"service": "google", "country": "de"}. Zachowaj identyfikator aktywacji z odpowiedzi.
4. Wpisz zwrócony numer w polu telefonu Google w swoim teście.
5. Odbierz kod przez webhook albo odpytując GET /api/v1/activations/{id}. Jeśli test zostanie porzucony, wywołaj POST /api/v1/activations/{id}/cancel.

Konto otrzymuje do 10 kluczy API i 300 żądań na minutę, a GET /api/v1/balance pozwala zestawowi testów sprawdzić środki przed startem. Każde pole odpowiedzi opisuje dokumentacja API.

Jak handler webhooka powinien traktować kody Google?

Zasubskrybuj jeden z pięciu swoich endpointów webhooków na activation.sms_received oraz na activation.expired i activation.cancelled, aby oczekujące zadania mogły zakończyć się czysto. Zanim zaufasz żądaniu, sparsuj X-OTPRoute-Signature (t=<unix>,v1=<hex>), oblicz ponownie HMAC-SHA256 z "<t>.<raw body>" przy użyciu sekretu endpointu, porównaj wynik w stałym czasie i odrzuć znaczniki czasu spoza krótkiej tolerancji.

Następnie uczyń handler idempotentnym. Zapisz identyfikator aktywacji przy pierwszym przetworzeniu zdarzenia i ignoruj późniejsze dostarczenia tego samego. Odpytywanie pozostaje dobrym rozwiązaniem zapasowym dla lokalnych przebiegów lub agentów CI za zaporą: sprawdzaj aktywację co kilka sekund, aż pokaże kod albo skończy się okno.

Kiedy Google prosi o numer telefonu?

Google wykorzystuje weryfikację telefoniczną w kilku miejscach, a to, które z nich się pojawi, zależy od konta i sytuacji:

• Rejestracja: tworzenie nowego konta Google może obejmować sprawdzenie telefonu, choć to Google decyduje, kiedy go wymagać.
• Weryfikacja dwuetapowa: kody SMS są jedną z opcji drugiego składnika logowania.
• Odzyskiwanie konta: telefon odzyskiwania może otrzymać kod, gdy ktoś zostanie zablokowany.
• Funkcje YouTube: niektóre funkcje kanału, takie jak dłuższe filmy i własne miniatury, odblokowują się po zweryfikowaniu telefonu.

Ma to znaczenie przy projektowaniu testów. Weryfikacja SMS Google w teście kroku rejestracji wymaga jednego kodu, natomiast weryfikacja dwuetapowa i odzyskiwanie wymagają później tego samego numeru. W pierwszym przypadku sprawdzi się numer jednorazowy; pozostałe omawiamy niżej.

W których krajach można odbierać OTP Google?

Usługa google jest obecnie dostępna w 199 krajach, w tym w Stanach Zjednoczonych, Niemczech, Indiach, Brazylii, Indonezji, Nigerii, Wielkiej Brytanii, Francji, Meksyku, Japonii, Turcji, Egipcie, na Filipinach, w Wietnamie i Pakistanie.

Wybór kraju nie jest kosmetyczny. Google potrafi dostosować język i komunikaty weryfikacyjne do regionu numeru, więc dopasuj numer do rynku, który reprezentuje Twoje konto testowe. Test lokalizacji na potrzeby premiery w Brazylii powinien używać numeru brazylijskiego, a nie tej trasy, która akurat jest najtańsza. Ceny różnią się w zależności od kraju, a strona cennika wyjaśnia, jak działają stawki na żywo.

Jak osoby niebędące deweloperami odbiorą kod Google z panelu?

Zaloguj się, doładuj portfel kartą lub USDT/USDC, a następnie wybierz Google (Gmail i YouTube) oraz kraj. Cena pojawia się przed potwierdzeniem. Skopiuj numer do pola numeru telefonu Google i zostaw otwartą stronę aktywacji; kod pojawi się tam, gdy dotrze SMS.

Pracownicy wsparcia i opiekunowie kont w agencjach często korzystają z tej ścieżki, gdy zakładają pojedyncze konto testowe lub markowe, podczas gdy zespół inżynierski obsługuje ten sam portfel przez API. Każde doładowanie dostaje fakturę PDF e-mailem, a opłaty miesięcznej nie ma.

Dlaczego Google może nie wysłać kodu i co wtedy zrobić?

Każda aktywacja ma 20-minutowe okno i płacisz tylko wtedy, gdy kod dotrze. Gdy okno zamyka się puste lub anulujesz zamówienie, pełna kwota wraca automatycznie do portfela.

Powody, dla których kod Google nie dociera:

• Google może w niektórych przepływach odrzucić numer wirtualny. Ta decyzja należy do Google, a zwrot to pokrywa.
• Trasa może być w danej chwili zajęta. Spróbuj później albo przez inny kraj, który nadal pasuje do Twojego testu.
• Wysyłka bywa po prostu wolna. Zanim anulujesz, pozwól oknu dobiec końca.

Po nieudanej próbie unikaj ponownego zamawiania w ciasnej pętli; rozłóż próby w czasie i zapisuj wynik dla każdego kraju, aby Twój zestaw testów uczył się, które trasy mu odpowiadają. W CI konto deweloperskie można na prośbę przełączyć w tryb sandbox, który zwraca symulowane numery i kody, dzięki czemu można przetestować sam harness bez wydawania środków z portfela.

Kiedy numer dedykowany lepiej pasuje do konta Google?

Numer jednorazowy obsługuje jeden kod. Jeśli testowe konto Google musi zalogować się ponownie za tydzień, przejść weryfikację dwuetapową albo skorzystać z odzyskiwania przez telefon, numer znikający po jednym użyciu zablokuje Ci dostęp. W takich przypadkach Dedicated Virtual Number w Stanach Zjednoczonych lub Kanadzie, od $1.95/month, pozostaje przy koncie na czas odnawiania i przekazuje przychodzące SMS-y na Twój webhook jako number.sms_received. Dla długo działających kont rozważ przeniesienie weryfikacji dwuetapowej do aplikacji uwierzytelniającej, gdy konto już istnieje.

Odpowiedzialne korzystanie ma tu znaczenie. Przestrzegaj regulaminu Google, utrzymuj jedno konto na jedną prawdziwą osobę lub firmę i używaj OTP Route wyłącznie do testowania i obsługi własnych, legalnych produktów i kont; obowiązuje jego polityka dopuszczalnego użytkowania (Acceptable Use Policy). Google, Gmail i YouTube są znakami towarowymi Google LLC, a OTP Route nie ma żadnych powiązań z Google.

Najczęstsze pytania

Czy mogę odebrać kod rejestracyjny Gmail przez API?

Tak. Utwórz aktywację z usługą google i wybranym krajem, wpisz numer w formularzu rejestracji i odbierz kod z webhooka lub przez odpytywanie aktywacji.

Czy ta sama usługa `google` obejmuje YouTube?

Tak. YouTube działa na kontach Google, więc weryfikacje telefonu dla funkcji YouTube korzystają z tego samego identyfikatora usługi.

Ile kosztuje kod weryfikacyjny Google?

Od $0.20 za kod, w zależności od kraju. Aktualną cenę zwraca GET /api/v1/prices, a jeśli kod nie dotrze w ciągu 20 minut, nic nie jest pobierane.

Czy mogę użyć numeru z OTP Gateway do weryfikacji dwuetapowej Google?

Nie do bieżących logowań, ponieważ numer obsługuje pojedynczy kod. Dla kont, do których będziesz się logować ponownie, użyj numeru Dedicated z USA lub Kanady albo aplikacji uwierzytelniającej.

Dlaczego Google napisał, że mój numer nie może być użyty?

Google decyduje, jakie numery akceptuje, i może odrzucać wirtualne. Anuluj lub poczekaj na wygaśnięcie aktywacji, by otrzymać automatyczny zwrot, a potem spróbuj później albo w innym odpowiednim kraju.

Jaki kraj wybrać dla konta testowego Google?

Wybierz rynek, który konto reprezentuje, aby język i komunikaty odpowiadały temu, co widzą tamtejsi użytkownicy. Przed zamówieniem sprawdź dostępność google przez GET /api/v1/prices.

Czy istnieje sandbox do testowania przepływu Google w CI?

Konto deweloperskie można na prośbę przełączyć w tryb sandbox. Zwraca on symulowane numery i kody, wystarczające do przetestowania logiki webhooka i odpytywania bez opłat z portfela.

Nazwy usług są znakami towarowymi ich właścicieli. OTP Route nie jest z nimi powiązany. Korzystaj z numerów zgodnie z prawem oraz przestrzegaj regulaminów poszczególnych usług i naszej Polityki akceptowalnego użytkowania.