خادم الحجز جاهز

تحتاج إلى خادم حجز للسماح لـ "مركز الإجراءات" بإجراء عمليات ردّ الاتصال لإنشاء حجوزات وتعديلها نيابةً عنك. يتيح ذلك لـ "مركز الإجراءات" إنشاء مواعيد وحجوزات لديك نيابةً عن المستخدم.

للتعرّف على كيفية ضبط إعدادات الاتصال بخوادم الحجز في وضعَي "وضع الحماية" و"الإنتاج"، يُرجى الاطّلاع على ضبط بيانات اعتماد خادم الحجز.

يُرجى إكمال المهام التالية في Booking Server Ready قبل الانتقال إلى "التعديلات في الوقت الفعلي":

يتم وضع علامة "مكتملة" على كل مهمة وتتحوّل إلى اللون الأخضر عند إرسال تفاصيل دقيقة وفي الوقت الفعلي حول المستودع إلى طلبات خادم الحجز من خلال مسار الحجز في Sandbox. يتم تحليل مراحل Booking Server على مدار 14 يومًا.

تنفيذ واجهة REST API

تنفيذ واجهة برمجة تطبيقات استنادًا إلى REST يتيح ذلك لـ Google إرسال طلبات إلى "خادم الحجز" عبر HTTPS.

لتنفيذ واجهة برمجة تطبيقات، عليك إعداد خادم حجز في بيئة تطوير أو بيئة تجريبية (Sandbox) يتصل ببيئة Sandbox في "مركز الإجراءات". انتقِل إلى بيئة إنتاج بعد اختبار خادم وضع الحماية بالكامل.

تكون جميع طلبات "خادم الحجز" من Google مرتبطة بعنوان URL لخادم الحجز الذي تم ضبطه في صفحة خادم الحجز. على سبيل المثال، إذا تم ضبط عنوان URL على api.example.com/google، سيتم إرسال جميع طلبات HealthCheck إلى api.example.com/google/v3/HealthCheck.

تأكَّد من ضبط نقطة نهاية "خادم الحجز" الصحيحة لكلّ من بيئة وضع الحماية وبيئة التشغيل باستخدام أداة تبديل البيئة.

الأمان والمصادقة

تتم جميع عمليات التواصل مع "خادم الحجز" عبر HTTPS باستخدام المصادقة الأساسية. للمساعدة في إعداد الخادم، ننصحك باستخدام أداة متاحة للجميع للتحقّق من بروتوكول أمان طبقة النقل (TLS) أو طبقة المقابس الآمنة (SSL)، مثل اختبار خادم SSL من Qualys.

تتم مصادقة جميع الطلبات التي ترسلها Google إلى "خادم الحجز" باستخدام المصادقة الأساسية عبر HTTPS. يمكنك إدخال معلومات المصادقة الأساسية وكلمة المرور واسم المستخدم الخاصين بخادم الحجز في صفحة إعداد خادم الحجز ضمن مركز الإجراءات. يجب تغيير بيانات الاعتماد كل ستة أشهر.

إنشاء خادم الحجز

يحدّد خادم الحجز طريقة تواصل عملية الدمج مع نظامك، ويجري الحجوزات أو يعدّلها. لضبط إعدادات الاتصال بخوادم الحجز في وضعَي Sandbox وProduction، يُرجى الاطّلاع على ضبط بيانات اعتماد خادم الحجز.

من المتوقّع أن يتضمّن كل ردّ يقدّمه "خادم الحجز" على طلب من "الحجز عبر Google" تفاصيل دقيقة وفي الوقت الفعلي حول المستودع. يعرض الجدول التالي طرق كل عملية تنفيذ، ويتضمّن روابط تؤدي إلى أشكال بروتوكول الخدمة:

الطريقة التعريف الردّ طلب HTTP
تحميل صفحة BatchAvailabilityLookup

عندما ينقر مستخدم على حجز طاولة لتاجرك، يتم استدعاء طلب BatchAvailabilityLookup عند تحميل الصفحة.

تحتوي الحمولة على العديد من الخانات التي تستند إلى آخر عمليات تحميل أجريتها على الخلاصة، والتي تعتبرها ميزة "الحجز عبر Google" متاحة.

 يجب أن يتضمّن الردّ كل طلب فتحة إعلانية ومعلومات حول مدى توفّرها حاليًا. يمنع هذا الإجراء عرض أي خانات غير متاحة. POST /v3/BatchAvailabilityLookup/
BatchAvailabilityLookup نقرة على المساحة الإعلانية عندما تظهر للمستخدم خانات متاحة للحجز وينقر على إحدى الخانات، يتم استدعاء طلب BatchAvailabilityLookup للنقرة على الخانة. يجب أن يمثّل الرد مدى التوفّر الحالي والفعلي للمكان المخصّص. إذا كانت الجلسة محجوزة بالكامل قبل النقر على الفترة الزمنية، يجب عرض الردّ بأنّها غير متاحة. POST /v3/BatchAvailabilityLookup/
CreateBooking عندما يؤكّد المستخدم أنّه يريد حجز فترة زمنية محدّدة في النافذة المنبثقة الخاصة بالحجز، يتم إرسال طلب CreateBooking.

يجب أن تمثّل الاستجابة نجاح عملية الحجز أو فشلها.

في حال تعذّر الحجز، عليك عرض السبب المحدّد لتعذّره. على سبيل المثال، تم حجز الفترة الزمنية قبل استدعاء الرد CreateBooking.

في حال إنشاء حجز ناجح، تتضمّن الاستجابة معرّفًا فريدًا booking_id للإشارة إلى الحجز في أي طلبات أو تعديلات مستقبلية.

 POST /v3/CreateBooking/‎
UpdateBooking بعد إجراء حجز من خلال "الحجز عبر Google"، يمكن للمستخدم اختيار تعديل الحجز. عندما يعدّل المستخدم حجزه أو يلغيه، يتم إرسال طلب UpdateBooking. مثل الردّ CreateBooking، يجب أن يوضّح ردّك على UpdateBooking ما إذا كان الحجز قد تم بنجاح أو أن يقدّم سببًا محدّدًا لتعذّره. POST /v3/UpdateBooking/‎
HealthCheck يُجري "مركز الإجراءات" مكالمات منتظمة إلى "خادم الحجز" للتأكّد من أنّ البنية الأساسية نشطة وتعمل.

استخدِم رمز حالة HTTP للإشارة إلى حالة عرض الخادم. أرسِل رمز الحالة HTTP 200 إذا كان الخادم نشطًا ويعمل بنجاح.

للإشارة إلى حدوث خطأ أو لإيقاف عملية الدمج مؤقتًا، عليك عرض رمز حالة HTTP المناسب الذي لا يبدأ بالرقم 2.

 GET /v3/HealthCheck/‎

مسار الحجز في وضع الحماية

لعرض مسار الحجز في وضع الاختبار، انتقِل إلى عرض المستودع في "مركز الإجراءات". يعرض عمود RwG - E2E في "طريقة عرض المستودع" رابط مباشر (في وضع الحماية) إلى مسار الحجز في وضع الحماية للتجّار الذين تمت مطابقتهم في وضع الحماية ولديهم مدى توفّر مستقبلي.

في ما يلي الإجراءات المضمّنة في مسار الحجز:

  • عند النقر على الرابط RwG - E2E، يتم تنشيط طلب BatchAvailabilityLookup عند تحميل الصفحة ويتم عرض معلومات التوفّر المعروفة لدى التاجر.
  • عند النقر على وقت الحجز، يتم تشغيل طلب BatchAvailabilityLookup on slot click ويتم عرض نافذة الحجز المنبثقة.
  • أكمِل الحجز باستخدام النافذة المنبثقة للحجز لإرسال طلب CreateBooking.
  • بعد إكمال الحجز في بيئة Sandbox، سيتلقّى الحساب المستخدَم لإنشاء الحجز رسالة تأكيد إلكترونية تتضمّن تفاصيل الحجز.
  • لتفعيل طريقة الدفع UpdateBooking، غيِّر الحجز أو ألغِه من الرسالة الإلكترونية.

HealthCheck

احرص على تنفيذ طريقة HealthCheck في وضعَي "وضع الحماية" و"الإنتاج". تعرض هذه الطريقة حالة سلامة "خادم الحجز". يتيح ذلك لشركة Google مراقبة حالة عرض "خادم الحجز" باستمرار.

الطلب: ما مِن طلب

القيمة المعروضة: ما مِن قيمة

استخدِم رمز حالة HTTP للإشارة إلى حالة عرض الخادم.

إذا كان الخادم نشطًا ويعمل بنجاح، عليك عرض رمز الحالة HTTP 200، أو عرض أحد رموز حالة HTTP للإشارة إلى حدوث خطأ.