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

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

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

يُرجى إكمال المهام التالية في "خادم الحجز جاهز" قبل الانتقال إلى "التعديلات في الوقت الفعلي":

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

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

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

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

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

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

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

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

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

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

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

يُفترض أن يحتوي كل ردّ يُرسله خادم الحجز على طلب من خدمة "الحجز على 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 غير 2xx المناسب.

 GET /v3/HealthCheck/

معايير المعالم الرئيسية

لإكمال المعلم الرئيسي "خادم الحجز جاهز"، يجب أن تستوفي عملية التكامل المعايير التالية في بيئتَي "وضع الحماية" و"بيئة الإنتاج":

الطريقة العدد المطلوب من الطلبات (وضع الحماية) العدد المطلوب من الطلبات (بيئة الإنتاج) معدّل النجاح المطلوب
تحميل صفحة BatchAvailabilityLookup 20 20 90%
النقر على خانة BatchAvailabilityLookup 20 20 90%
CreateBooking 10 3 90%
UpdateBooking 10 3 90%

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

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

في ما يلي الإجراءات في مسار الحجز:

  • عند النقر على الرابط الحجز على Google - تجربة متكاملة ، يتم تنشيط طلب BatchAvailabilityLookup عند تحميل الصفحة وعرض مدى التوفّر المعروف لدى التاجر.

  • عند النقر على وقت الحجز، يتم تنشيط طلب BatchAvailabilityLookup عند النقر على الخانة وعرض نموذج الحجز.

  • أكمِل الحجز باستخدام نموذج الحجز لإرسال طلب CreateBooking.

  • بعد إكمال الحجز في بيئة "وضع الحماية"، يتلقّى الحساب المستخدَم لإنشاء الحجز رسالة تأكيد إلكترونية تتضمّن تفاصيل الحجز.

  • لتنشيط طريقة UpdateBooking، يمكنك تغيير الحجز أو إلغاؤه من الرسالة الإلكترونية.

HealthCheck

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

الطلب: لا شيء

القيمة المعروضة: لا شيء

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

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