Nhận mã SMS của Google (Gmail và YouTube) trong pipeline kiểm thử của bạn

Luồng API mã xác minh Google trông như thế nào?

Mã dịch vụ là google, bao gồm Gmail, YouTube và toàn bộ tài khoản Google. Các yêu cầu được gửi tới https://otproute.com/api/v1 kèm khóa Bearer có tiền tố or_live_.

1. Chọn mã quốc gia từ GET /api/v1/countries, ví dụ de hoặc in.
2. Đọc giá hiện tại bằng GET /api/v1/prices?country=de&service=google. Một tuyến đang đóng sẽ hiện ra ở đây, trước khi bạn tốn đồng nào.
3. Tạo đơn: POST /api/v1/activations với {"service": "google", "country": "de"}. Giữ lại activation id từ phản hồi.
4. Nhập số được trả về vào ô nhập điện thoại của Google trong bài kiểm thử của bạn.
5. Nhận mã qua webhook hoặc bằng cách thăm dò GET /api/v1/activations/{id}. Nếu bài kiểm thử bị bỏ dở, hãy gọi POST /api/v1/activations/{id}/cancel.

Mỗi tài khoản có tối đa 10 khóa API và 300 yêu cầu mỗi phút, và GET /api/v1/balance cho phép bộ kiểm thử kiểm tra số dư trước khi bắt đầu. Tài liệu API mô tả từng trường của phản hồi.

Trình xử lý webhook nên đối xử với mã Google như thế nào?

Hãy đăng ký một trong năm endpoint webhook của bạn với activation.sms_received, cùng activation.expired và activation.cancelled để các tác vụ đang chờ có thể thoát gọn gàng. Trước khi tin một yêu cầu, hãy phân tích X-OTPRoute-Signature (t=<unix>,v1=<hex>), tính lại HMAC-SHA256 trên "<t>.<raw body>" bằng secret của endpoint, so sánh trong thời gian hằng định, và từ chối các dấu thời gian nằm ngoài một ngưỡng dung sai ngắn.

Sau đó hãy làm cho trình xử lý có tính idempotent. Ghi lại activation id ngay lần đầu bạn xử lý một sự kiện và bỏ qua các lần gửi sau của cùng sự kiện đó. Thăm dò vẫn là phương án dự phòng tốt cho các lần chạy cục bộ hoặc các agent CI nằm sau tường lửa: truy vấn activation vài giây một lần cho đến khi nó báo có mã hoặc khung thời gian kết thúc.

Khi nào Google yêu cầu số điện thoại?

Google dùng xác minh qua điện thoại ở nhiều thời điểm, và thời điểm nào xuất hiện còn tùy vào tài khoản và hoàn cảnh:

• Đăng ký: tạo tài khoản Google mới có thể kèm bước kiểm tra điện thoại, dù việc khi nào yêu cầu do Google quyết định.
• Xác minh 2 bước: mã SMS là một trong các lựa chọn yếu tố thứ hai khi đăng nhập.
• Khôi phục tài khoản: một điện thoại khôi phục có thể nhận mã khi ai đó bị khóa tài khoản.
• Tính năng YouTube: một số tính năng của kênh, chẳng hạn tải lên video dài hơn và hình thu nhỏ tùy chỉnh, được mở khóa sau khi điện thoại được xác minh.

Điều này quan trọng với thiết kế kiểm thử. Kiểm thử xác minh SMS Google ở bước đăng ký chỉ cần một mã, còn Xác minh 2 bước và khôi phục cần dùng lại cùng số đó về sau. Số dùng một lần phù hợp với trường hợp đầu; các trường hợp còn lại được đề cập ở phần dưới.

Những quốc gia nào có thể nhận OTP của Google?

Dịch vụ google hiện có ở 199 quốc gia, trong đó có Hoa Kỳ, Đức, Ấn Độ, Brazil, Indonesia, Nigeria, Vương quốc Anh, Pháp, Mexico, Nhật Bản, Thổ Nhĩ Kỳ, Ai Cập, Philippines, Việt Nam và Pakistan.

Việc chọn quốc gia không chỉ là hình thức. Google có thể điều chỉnh ngôn ngữ và lời nhắc xác minh theo khu vực của số điện thoại, nên hãy khớp số với thị trường mà tài khoản thử nghiệm của bạn đại diện. Một đợt kiểm thử bản địa hóa cho lần ra mắt tại Brazil nên dùng số Brazil, không phải tuyến nào rẻ nhất. Giá khác nhau theo quốc gia, và trang giá giải thích cách các mức giá trực tiếp hoạt động.

Người không phải nhà phát triển lấy mã Google từ dashboard bằng cách nào?

Đăng nhập, nạp tiền vào ví bằng thẻ hoặc USDT/USDC, rồi chọn Google (Gmail và YouTube) và một quốc gia. Giá hiển thị trước khi bạn xác nhận. Sao chép số vào ô số điện thoại của Google và để trang activation mở; mã sẽ xuất hiện ở đó khi SMS đến.

Nhân viên hỗ trợ và quản lý tài khoản agency thường dùng cách này khi thiết lập một tài khoản thử nghiệm hoặc tài khoản thương hiệu đơn lẻ, trong khi đội kỹ thuật điều khiển cùng chiếc ví đó qua API. Mỗi lần nạp tiền đều kèm hóa đơn PDF gửi qua email, và không có phí hằng tháng.

Vì sao Google có thể không gửi mã, và bạn có thể làm gì?

Mỗi activation có khung thời gian 20 phút, và bạn chỉ trả tiền nếu mã đến. Khi khung thời gian đóng mà không có gì, hoặc bạn hủy, toàn bộ số tiền được hoàn về ví của bạn một cách tự động.

Các lý do khiến mã Google không đến:

• Google có thể từ chối số ảo cho việc xác minh Google ở một số luồng. Quyết định đó thuộc về Google, và việc hoàn tiền bao trùm trường hợp này.
• Tuyến có thể đang bận vào lúc đó. Hãy thử lại sau hoặc với một quốc gia khác vẫn phù hợp với bài kiểm thử.
• Việc gửi đơn giản có thể chậm. Hãy để khung thời gian chạy hết trước khi hủy.

Tránh đặt lại liên tục trong một vòng lặp dày sau một lần thất bại; hãy giãn cách các lần thử và ghi lại kết quả theo từng quốc gia để bộ kiểm thử của bạn biết tuyến nào phù hợp. Với CI, một tài khoản phát triển có thể được chuyển sang sandbox theo yêu cầu, trả về các số và mã mô phỏng để bản thân bộ khung kiểm thử có thể được thử mà không tốn tiền trong ví.

Khi nào Dedicated Number phù hợp hơn cho tài khoản Google?

Một số dùng một lần chỉ phục vụ một mã. Nếu một tài khoản Google thử nghiệm phải đăng nhập lại vào tuần sau, vượt qua Xác minh 2 bước hoặc dùng khôi phục qua điện thoại, một số biến mất sau một lần dùng sẽ khiến bạn bị khóa ngoài. Trong những trường hợp đó, một Dedicated Virtual Number tại Hoa Kỳ hoặc Canada, từ $1.95/month, gắn với tài khoản trong khi được gia hạn và chuyển tiếp SMS đến tới webhook của bạn dưới dạng number.sms_received. Với các tài khoản dùng lâu dài, hãy cân nhắc chuyển Xác minh 2 bước sang ứng dụng xác thực sau khi tài khoản đã được tạo.

Sử dụng có trách nhiệm là điều quan trọng ở đây. Hãy tuân thủ điều khoản của Google, chỉ dùng một tài khoản cho mỗi cá nhân hoặc doanh nghiệp thực, và chỉ dùng OTP Route để kiểm thử và vận hành các sản phẩm và tài khoản hợp pháp của chính bạn; Chính sách Sử dụng Chấp nhận được (Acceptable Use Policy) của OTP Route được áp dụng. Google, Gmail và YouTube là nhãn hiệu của Google LLC, và OTP Route không có liên kết nào với Google.

Câu hỏi thường gặp

Tôi có thể nhận mã đăng ký Gmail qua API không?

Có. Tạo một activation với dịch vụ google và quốc gia bạn chọn, nhập số vào biểu mẫu đăng ký, rồi lấy mã từ webhook hoặc bằng cách thăm dò activation.

Dịch vụ `google` có bao gồm cả YouTube không?

Có. YouTube chạy trên tài khoản Google, nên các bước kiểm tra điện thoại cho tính năng YouTube dùng cùng mã dịch vụ.

Một mã xác minh Google có giá bao nhiêu?

Từ $0.20 mỗi mã, tùy theo quốc gia. Giá hiện tại đến từ GET /api/v1/prices, và sẽ không bị tính phí nếu mã không đến trong 20 phút.

Tôi có thể dùng số OTP Gateway cho Xác minh 2 bước của Google không?

Không cho các lần đăng nhập về sau, vì số chỉ phục vụ một mã. Hãy dùng Dedicated Number của Hoa Kỳ hoặc Canada, hoặc một ứng dụng xác thực, cho các tài khoản bạn sẽ đăng nhập lại.

Vì sao Google báo số của tôi không thể được sử dụng?

Google quyết định số nào được chấp nhận và có thể từ chối số ảo. Hãy hủy hoặc để activation hết hạn để được hoàn tiền tự động, rồi thử lại sau hoặc ở một quốc gia phù hợp khác.

Tôi nên chọn quốc gia nào cho tài khoản thử nghiệm Google?

Hãy chọn thị trường mà tài khoản đại diện, để ngôn ngữ và lời nhắc khớp với những gì người dùng thật ở đó nhìn thấy. Kiểm tra tình trạng khả dụng trực tiếp của google bằng GET /api/v1/prices trước khi đặt số.

Có sandbox để thử luồng Google trong CI không?

Một tài khoản phát triển có thể được chuyển sang sandbox theo yêu cầu. Nó trả về các số và mã mô phỏng, đủ để kiểm thử logic webhook và thăm dò mà không bị trừ tiền trong ví.

Tên dịch vụ là nhãn hiệu của chủ sở hữu tương ứng. OTP Route không liên kết với họ. Hãy sử dụng số hợp pháp, tuân thủ điều khoản của từng dịch vụ và Chính sách sử dụng chấp nhận được của chúng tôi.