استقبال رسائل SMS من جوجل (Gmail ويوتيوب) في مسار الاختبار لديك

كيف يبدو مسار واجهة API لرمز تحقق جوجل؟

معرّف الخدمة هو google، وهو يغطي Gmail ويوتيوب وحساب جوجل عمومًا. تُرسل الطلبات إلى https://otproute.com/api/v1 بمفتاح Bearer ببادئة or_live_.

1. اختر معرّف دولة من GET /api/v1/countries، مثل de أو in.
2. اقرأ السعر الحي عبر GET /api/v1/prices?country=de&service=google. المسار المغلق يظهر هنا قبل أن تنفق شيئًا.
3. أنشئ الطلب: POST /api/v1/activations مع {"service": "google", "country": "de"}. احتفظ بمعرّف التفعيل من الاستجابة.
4. أدخل الرقم المُعاد عند طلب جوجل رقم الهاتف في اختبارك.
5. استلم الرمز عبر webhook أو بالاستعلام عن GET /api/v1/activations/{id}. وإذا أُلغي الاختبار فاستدعِ POST /api/v1/activations/{id}/cancel.

يحصل الحساب على ما يصل إلى 10 مفاتيح API و300 طلب في الدقيقة، ويتيح GET /api/v1/balance لمجموعة الاختبارات فحص الرصيد قبل أن تبدأ. وتصف وثائق API كل حقل في الاستجابة.

كيف ينبغي أن يتعامل معالج webhook مع رموز جوجل؟

اشترك بإحدى نقاط الـ webhook الخمس في activation.sms_received، وكذلك activation.expired وactivation.cancelled لتخرج المهام المنتظرة بسلاسة. قبل الوثوق بأي طلب، حلّل X-OTPRoute-Signature (t=<unix>,v1=<hex>)، وأعد حساب HMAC-SHA256 على "<t>.<raw body>" بسرّ نقطة النهاية، وقارنه بزمن ثابت، وارفض الطوابع الزمنية الخارجة عن هامش قصير.

ثم اجعل المعالج idempotent. سجّل معرّف التفعيل أول مرة تعالج فيها حدثًا وتجاهل ما يصل لاحقًا بالمعرّف نفسه. ويبقى الاستعلام الدوري بديلًا جيدًا للتشغيلات المحلية أو وكلاء CI خلف جدار ناري: استعلم عن التفعيل كل بضع ثوانٍ حتى يعرض الرمز أو تنتهي النافذة.

متى يطلب جوجل رقم هاتف؟

يستخدم جوجل التحقق عبر الهاتف في عدة مواضع، ويعتمد الظاهر منها على الحساب والموقف:

• التسجيل: قد يتضمن إنشاء حساب جوجل جديد فحصًا للهاتف، وجوجل هو من يقرر متى يطلبه.
• التحقق بخطوتين: رموز SMS أحد خيارات العامل الثاني لتسجيل الدخول.
• استعادة الحساب: يمكن لهاتف الاسترداد أن يستلم رمزًا عند الإغلاق خارج الحساب.
• ميزات يوتيوب: تُفتح بعض ميزات القناة، كالتحميلات الأطول والصور المصغّرة المخصّصة، بعد توثيق الهاتف.

وهذا مهم لتصميم الاختبار. فاختبار خطوة التسجيل بالتحقق عبر SMS من جوجل يحتاج رمزًا واحدًا، أما التحقق بخطوتين والاستعادة فيحتاجان الرقم نفسه لاحقًا. الرقم ذو الاستخدام الواحد يناسب الحالة الأولى؛ أما الباقي فنتناوله أدناه.

ما الدول التي يمكنها استقبال رموز OTP من جوجل؟

خدمة google متاحة حاليًا في 199 دولة، منها الولايات المتحدة وألمانيا والهند والبرازيل وإندونيسيا ونيجيريا، إضافة إلى المملكة المتحدة وفرنسا والمكسيك واليابان وتركيا ومصر والفلبين وفيتنام وباكستان.

اختيار الدولة ليس شكليًا. فقد يكيّف جوجل اللغة ورسائل التحقق بحسب منطقة الرقم، لذا طابق الرقم مع السوق الذي يمثله حساب الاختبار. فتجربة توطين لإطلاق في البرازيل ينبغي أن تستخدم رقمًا برازيليًا، لا أرخص مسار متاح. والأسعار تختلف بين الدول، وتشرح صفحة الأسعار طريقة عمل الأسعار الحية.

كيف يحصل غير المطوّرين على رمز جوجل من لوحة التحكم؟

سجّل الدخول، واشحن المحفظة بالبطاقة أو USDT/USDC، ثم اختر Google (Gmail وYouTube) والدولة. يظهر السعر قبل التأكيد. انسخ الرقم إلى حقل رقم الهاتف في جوجل وأبقِ صفحة التفعيل مفتوحة؛ سيظهر الرمز فيها عند وصول الرسالة.

يستخدم موظفو الدعم ومديرو حسابات الوكالات هذا المسار غالبًا عند إعداد اختبار واحد أو حساب علامة تجارية، بينما يقود فريق الهندسة المحفظة نفسها عبر API. وكل عملية شحن تأتي معها فاتورة PDF بالبريد الإلكتروني، ولا توجد رسوم شهرية.

لماذا قد لا يرسل جوجل رمزًا، وماذا يمكنك أن تفعل؟

لكل تفعيل نافذة مدتها 20 دقيقة، ولا تدفع إلا إذا وصل الرمز. وعندما تنتهي النافذة فارغة، أو تلغي الطلب، يعود المبلغ كاملًا إلى محفظتك تلقائيًا.

أسباب عدم وصول رمز جوجل:

• قد يرفض جوجل رقمًا افتراضيًا للتحقق في بعض المسارات. هذا القرار بيد جوجل، والاسترداد يغطي الحالة.
• قد يكون المسار مزدحمًا في تلك اللحظة. أعد المحاولة لاحقًا أو بدولة أخرى ما زالت تناسب اختبارك.
• قد يكون الإرسال بطيئًا ببساطة. اترك النافذة تكتمل قبل الإلغاء.

تجنّب إعادة الطلب في حلقة سريعة بعد الإخفاق؛ باعد بين المحاولات وسجّل النتيجة لكل دولة لتتعلم مجموعة اختباراتك أي المسارات تناسبها. وفي CI يمكن نقل حساب التطوير إلى sandbox عند الطلب، فيعيد أرقامًا ورموزًا محاكاة لاختبار الأداة نفسها دون إنفاق من المحفظة.

متى يكون الرقم المخصّص الأنسب لحساب جوجل؟

الرقم ذو الاستخدام الواحد يصلح لرمز واحد. وإذا كان حساب جوجل التجريبي سيدخل مجددًا الأسبوع المقبل، أو يمرّ بالتحقق بخطوتين، أو يستخدم الاسترداد عبر الهاتف، فإن رقمًا يختفي بعد استخدام واحد سيُقفل عليك الحساب. في هذه الحالات يبقى الرقم الافتراضي المخصّص في الولايات المتحدة أو كندا، بدءًا من $1.95 شهريًا، مع الحساب طالما يتجدد، ويحوّل الرسائل الواردة إلى webhook بصيغة number.sms_received. وللحسابات طويلة الأمد، فكّر في نقل التحقق بخطوتين إلى تطبيق مصادقة بعد إنشاء الحساب.

والاستخدام المسؤول مهم هنا. التزم بشروط جوجل، وبحساب واحد لكل شخص حقيقي أو نشاط تجاري، واستخدم OTP Route فقط لاختبار منتجاتك وحساباتك المشروعة وتشغيلها؛ وتسري سياسة الاستخدام المقبول لديه. Google وGmail وYouTube علامات تجارية لشركة Google LLC، وOTP Route لا ينتمي إلى جوجل.

الأسئلة الشائعة

هل أستطيع استقبال رمز تسجيل Gmail عبر API؟

نعم. أنشئ تفعيلًا بالخدمة google والدولة التي تختارها، وأدخل الرقم في نموذج التسجيل، واستلم الرمز من webhook أو بالاستعلام عن التفعيل.

هل تغطي خدمة `google` نفسها يوتيوب؟

نعم. يعمل يوتيوب بحسابات جوجل، لذا تستخدم فحوص الهاتف لميزاته معرّف الخدمة نفسه.

كم يكلّف رمز تحقق جوجل؟

من $0.20 للرمز بحسب الدولة. يأتي السعر الحي من GET /api/v1/prices، ولا يُحتسب شيء إذا لم يصل الرمز خلال 20 دقيقة.

هل أستخدم رقم OTP Gateway للتحقق بخطوتين في جوجل؟

ليس لعمليات الدخول المستمرة، لأن الرقم يخدم رمزًا واحدًا. استخدم رقمًا مخصّصًا أمريكيًا أو كنديًا، أو تطبيق مصادقة، للحسابات التي ستدخلها مجددًا.

لماذا قال جوجل إن رقمي لا يمكن استخدامه؟

جوجل هو من يحدد الأرقام التي يقبلها وقد يرفض الافتراضية منها. ألغِ التفعيل أو دعه ينتهي لاسترداد تلقائي، ثم جرّب لاحقًا أو في دولة مناسبة أخرى.

أي دولة أختار لحساب جوجل تجريبي؟

اختر السوق الذي يمثله الحساب، لتطابق اللغة والرسائل ما يراه المستخدمون الحقيقيون هناك. وتحقق من الإتاحة الحية لـ google عبر GET /api/v1/prices قبل الطلب.

هل يوجد sandbox لاختبار مسار جوجل في CI؟

يمكن نقل حساب التطوير إلى sandbox عند الطلب. يعيد أرقامًا ورموزًا محاكاة، تكفي لاختبار منطق webhook والاستعلام دون خصم من المحفظة.

أسماء الخدمات علامات تجارية لأصحابها. OTP Route غير تابعة لهم. استخدم الأرقام بصورة قانونية والتزم بشروط كل خدمة وبسياسة الاستخدام المقبول لدينا.