테스트 파이프라인에서 Google(Gmail·YouTube) SMS 코드 받기

Google 인증 코드 API 흐름은 어떤 모습인가요?

서비스 ID는 google이며 Gmail, YouTube, 그리고 더 넓은 Google 계정을 모두 포함합니다. 요청은 or_live_ 접두사의 Bearer 키와 함께 https://otproute.com/api/v1로 보냅니다.

1. GET /api/v1/countries에서 국가 ID를 고릅니다(예: de, in).
2. GET /api/v1/prices?country=de&service=google로 실시간 가격을 확인합니다. 닫힌 경로는 비용을 쓰기 전에 여기서 드러납니다.
3. 주문을 생성합니다. POST /api/v1/activations에 {"service": "google", "country": "de"}를 보내고, 응답의 활성화 ID를 보관하세요.
4. 테스트에서 Google의 전화번호 입력창에 반환된 번호를 입력합니다.
5. 웹훅으로 코드를 받거나 GET /api/v1/activations/{id}를 폴링합니다. 테스트를 중단했다면 POST /api/v1/activations/{id}/cancel을 호출하세요.

계정당 API 키는 최대 10개, 요청은 분당 300건까지 가능하며, GET /api/v1/balance로 테스트 스위트가 시작 전에 잔액을 확인할 수 있습니다. 각 응답 필드는 API 문서에 설명되어 있습니다.

웹훅 핸들러는 Google 코드를 어떻게 처리해야 하나요?

웹훅 엔드포인트 5개 중 하나를 activation.sms_received에 구독시키고, 대기 중인 작업이 깔끔하게 종료되도록 activation.expired와 activation.cancelled에도 구독하세요. 요청을 신뢰하기 전에 X-OTPRoute-Signature(t=<unix>,v1=<hex>)를 파싱하고, 엔드포인트 시크릿으로 "<t>.<raw body>"의 HMAC-SHA256을 다시 계산해 상수 시간 비교로 대조하며, 짧은 허용 범위를 벗어난 타임스탬프는 거부합니다.

그다음 핸들러를 멱등하게 만드세요. 이벤트를 처음 처리할 때 활성화 ID를 기록하고 같은 이벤트의 이후 전달은 무시합니다. 로컬 실행이나 방화벽 뒤의 CI 에이전트에서는 폴링이 여전히 좋은 대안입니다. 코드가 보고되거나 시간이 끝날 때까지 몇 초마다 활성화를 조회하세요.

Google은 언제 전화번호를 요구하나요?

Google은 여러 시점에 전화번호 인증을 사용하며, 어떤 것이 나타나는지는 계정과 상황에 따라 다릅니다.

• 가입: 새 Google 계정을 만들 때 전화번호 확인이 포함될 수 있지만, 필요 여부는 Google이 정합니다.
• 2단계 인증: SMS 코드는 로그인할 때의 두 번째 인증 수단 중 하나입니다.
• 계정 복구: 계정에 접근할 수 없을 때 복구용 전화번호로 코드를 받을 수 있습니다.
• YouTube 기능: 긴 영상 업로드, 맞춤 썸네일 같은 일부 채널 기능은 전화번호를 인증한 후 열립니다.

이는 테스트 설계에 중요합니다. 가입 단계를 테스트하는 Google SMS 인증은 코드 하나면 되지만, 2단계 인증과 복구는 나중에 같은 번호가 다시 필요합니다. 첫 번째 경우에는 일회용 번호가 적합하고, 나머지는 아래에서 다룹니다.

어떤 국가에서 Google OTP를 받을 수 있나요?

google 서비스는 현재 199개국에서 이용할 수 있으며, 미국, 독일, 인도, 브라질, 인도네시아, 나이지리아를 비롯해 영국, 프랑스, 멕시코, 일본, 튀르키예, 이집트, 필리핀, 베트남, 파키스탄 등이 포함됩니다.

국가 선택은 형식적인 것이 아닙니다. Google은 번호의 지역에 맞춰 언어와 인증 안내를 바꿀 수 있으므로, 테스트 계정이 나타내는 시장에 번호를 맞추세요. 브라질 출시를 위한 현지화 테스트라면 가장 저렴한 경로가 아니라 브라질 번호를 써야 합니다. 가격은 국가마다 다르며, 실시간 요금이 어떻게 적용되는지는 요금 페이지에서 설명합니다.

개발자가 아닌 사람은 대시보드에서 Google 코드를 어떻게 받나요?

로그인해서 카드 또는 USDT/USDC로 지갑을 충전한 뒤 Google(Gmail & YouTube)과 국가를 선택하세요. 가격은 확정하기 전에 표시됩니다. 번호를 Google의 전화번호 입력란에 복사하고 활성화 페이지를 열어 두면, SMS가 도착했을 때 코드가 그곳에 나타납니다.

지원 담당자와 에이전시 계정 매니저는 테스트용 또는 브랜드 계정 하나를 설정할 때 이 방법을 자주 쓰고, 엔지니어링 팀은 같은 지갑을 API로 운영합니다. 충전할 때마다 PDF 인보이스가 이메일로 발송되며 월 이용료는 없습니다.

Google이 코드를 보내지 않는 이유는 무엇이고, 어떻게 해야 하나요?

각 활성화에는 20분의 시간이 있고, 코드가 도착했을 때만 비용을 냅니다. 시간이 비어 있는 채로 끝나거나 취소하면 전액이 자동으로 지갑에 돌아옵니다.

Google 코드가 도착하지 않는 이유는 다음과 같습니다.

• 일부 흐름에서 Google이 Google 인증용 가상 번호를 거부할 수 있습니다. 이는 Google의 결정이며 환불로 보상됩니다.
• 그 시점에 경로가 혼잡할 수 있습니다. 나중에 또는 테스트에 여전히 맞는 다른 국가로 재시도하세요.
• 전송이 단순히 느릴 수도 있습니다. 취소하기 전에 시간이 끝까지 가도록 두세요.

실패 후 빠른 반복문으로 재주문하지 말고 시도 간격을 두며, 스위트가 어떤 경로가 맞는지 학습하도록 국가별 결과를 기록하세요. CI에서는 요청 시 개발 계정을 샌드박스로 전환할 수 있으며, 시뮬레이션된 번호와 코드가 반환되므로 지갑 비용 없이 테스트 하네스 자체를 검증할 수 있습니다.

Google 계정에는 언제 Dedicated Number가 더 적합한가요?

일회용 번호는 코드 한 번에만 쓸 수 있습니다. Google 테스트 계정이 다음 주에 다시 로그인하거나, 2단계 인증을 통과하거나, 전화 복구를 써야 한다면 한 번 쓰고 사라지는 번호로는 계정이 잠길 수 있습니다. 이런 경우에는 미국 또는 캐나다의 Dedicated Virtual Number가 적합합니다. 월 $1.95부터이며, 갱신되는 동안 계정과 함께 유지되고 수신 SMS를 number.sms_received로 웹훅에 전달합니다. 오래 쓸 계정이라면 계정이 만들어진 뒤 2단계 인증을 인증 앱으로 옮기는 것도 고려하세요.

책임 있는 사용도 중요합니다. Google의 약관을 지키고, 실제 개인 또는 사업체당 계정 하나만 유지하며, OTP Route는 자사의 합법적인 제품과 계정을 테스트하고 운영하는 용도로만 쓰세요. OTP Route의 이용 정책(Acceptable Use Policy)이 적용됩니다. Google, Gmail, YouTube는 Google LLC의 상표이며, OTP Route는 Google과 제휴 관계가 없습니다.

자주 묻는 질문

API로 Gmail 가입 코드를 받을 수 있나요?

네. 서비스 google과 원하는 국가로 활성화를 만들고, 가입 양식에 번호를 입력한 뒤 웹훅 또는 활성화 폴링으로 코드를 수집하세요.

같은 `google` 서비스가 YouTube도 포함하나요?

네. YouTube는 Google 계정으로 동작하므로 YouTube 기능의 전화번호 확인에도 같은 서비스 ID를 씁니다.

Google 인증 코드는 얼마인가요?

국가에 따라 코드당 $0.20부터입니다. 실시간 가격은 GET /api/v1/prices에서 확인하며, 20분 안에 코드가 도착하지 않으면 아무것도 청구되지 않습니다.

Google 2단계 인증에 OTP Gateway 번호를 쓸 수 있나요?

계속 로그인하는 용도로는 안 됩니다. 번호가 코드 한 번만 처리하기 때문입니다. 다시 로그인할 계정에는 미국 또는 캐나다의 Dedicated Number나 인증 앱을 사용하세요.

Google이 이 번호는 사용할 수 없다고 하는 이유는 무엇인가요?

Google이 허용하는 번호를 스스로 결정하며 가상 번호를 거부할 수 있습니다. 활성화를 취소하거나 만료시키면 자동으로 환불되니, 나중에 또는 적합한 다른 국가로 다시 시도하세요.

Google 테스트 계정에는 어느 국가를 골라야 하나요?

계정이 대표하는 시장을 고르면 언어와 안내가 실제 현지 사용자가 보는 것과 일치합니다. 주문 전에 GET /api/v1/prices로 google의 실시간 가용성을 확인하세요.

CI에서 Google 흐름을 테스트할 샌드박스가 있나요?

요청 시 개발 계정을 샌드박스로 전환할 수 있습니다. 시뮬레이션된 번호와 코드가 반환되어 지갑 비용 없이 웹훅과 폴링 로직을 테스트할 수 있습니다.

서비스 이름은 각 소유자의 상표입니다. OTP Route는 해당 소유자와 제휴 관계가 없습니다. 번호는 합법적으로 사용하고, 각 서비스의 약관과 당사의 허용 가능한 사용 정책을 준수하세요.