نظرة عامة

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

عملية الإطلاق

يوضّح الشكل 1 عملية إطلاق التجّار الذين تم تفعيل قوائم الانتظار لديهم في "مركز الإجراءات".

الشكل 1: خطوات الدمج عالية المستوى
الشكل 1: خطوات دمج عالية المستوى

بشكل عام، يتم تسجيل تدفقات البيانات الرئيسية بينك (الشريك) وبين Google في الشكل 2:

الشكل 2: مخطط تدفق بيانات الدمج
الشكل 2: مخطّط بياني لتدفق بيانات الدمج

إرشادات لجميع شركاء قوائم انتظار الحجوزات

يُرجى مراعاة ما يلي عند استخدام ميزة قوائم انتظار الحجوزات:

  • يجب أن تتم تعبئة السمة waitlist_rules في الخدمة لكل تاجر في قوائم الانتظار ضمن "الحجوزات".
    • يجب استخدام الخدمة نفسها لكلّ من قائمة الانتظار والحجز. بمعنى آخر، إذا كان مطعمك يسمح أيضًا بالحجوزات، ما عليك سوى إضافة البيانات الوصفية ذات الصلة بقائمة الانتظار إلى خدمة الحجز.
  • يكون إرسال آخر الأخبار عبر الرسائل القصيرة مطلوبًا لتنفيذ قائمة الانتظار في الحالات التالية:
    • لتأكيد انضمام المستخدم إلى قائمة الانتظار بنجاح
    • لإعلام المستخدم بأن جدوله جاهز.
    • لإعلام المستخدم بإلغاء إدخال قائمة الانتظار
  • يجب أن تحتوي الرسائل القصيرة على رابط يؤدي إلى صفحة يمكن للمستخدمين من خلالها عرض حالة قائمة الانتظار.
  • لا يحتاج التجّار المُدرَجون في قائمة الانتظار فقط إلى تقديم خلاصات مدى التوفّر في "مركز الإجراءات".
  • على خادم الحجز تنفيذ جميع الخطوات الخاصة بقائمة الانتظار الواردة في تنفيذ خادم الحجز. ويمكن للشركاء الذين يتيحون لكل من الحجوزات وقوائم الانتظار إضافة الطرق الجديدة إلى خادم الحجز الحالي.
  • يدير "مركز الإجراءات" مجموعة من طلبات الاختبار لطرق قوائم الانتظار في خادم الحجز.

مخطط انسيابي للحالة

يصف هذا الرسم البياني الحالات التي يجب الإبلاغ عنها في WaitlistEntry.waitlist_entry_state عند الاستجابة لمكالمات GetWaitlistEntry . يشير الرسم البياني أيضًا إلى وقت تسجيل حقول WaitlistEntry.waitlist_entry_state_times.*_time_seconds وتعبئتها ومتى يتم إرسال رسالة قصيرة إلى المستخدم لإبلاغه بأنّه أدخل حالة جديدة.

الشكل 3: مخطط انسيابي لحالة قائمة الانتظار
الشكل: 3 رسم بياني انسيابي لحالة قائمة الانتظار

الحالات الهامشية الشائعة

في ما يلي الحالات الحدّية الشائعة في عملية دمج قوائم الانتظار في الحجوزات والحلول المفضّلة لها.

  • إذا كانت بعض أحجام الحفلات (وليس جميعها) لا تقبل إضافات جديدة إلى قوائم الانتظار لأنّه ليس هناك انتظار لأحجام الحفلات هذه، سيتم عرض WaitEstimates لجميع أحجام الحفلات في استجابة BatchGetWaitEstimates والسماح للمستخدمين بالانضمام إلى قائمة الانتظار لأحجام الحفلات هذه بدون انتظار. عرض WaitLength مع 0 parties_ahead_count و/أو مع estimated_seat_time_range مع 0 start_seconds و0 end_seconds في party_size بدون انتظار
  • إذا كان حجم مجموعة واحدة أو أكثر لا يقبل إضافات جديدة إلى قائمة الانتظار لأنّ فترة الانتظار طويلة جدًا، يُفضَّل حذف WaitEstimates لأحجام هذه المجموعة في ردّ BatchGetWaitEstimates.

ويُفضَّل استخدام هذه الأساليب لأنّها توفّر للمستخدمين خيارات مع أنّ قائمة الانتظار لدى التاجر قد لا تكون مفتوحة بالكامل.

إرشادات للشركاء الذين لديهم إذن الوصول إلى قوائم الانتظار فقط

يُرجى أخذ النقاط التالية في الاعتبار إذا كان خادم الحجز يُستخدم لقوائم الانتظار فقط:

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

إرشادات للشركاء الذين يجب على تجّارهم قبول أو رفض إضافات قوائم الانتظار يدويًا

إذا كان التجّار بحاجة إلى إمكانية قبول أو رفض إضافات قوائم الانتظار الجديدة من Google يدويًا، يجب اتخاذ خطوات إضافية:

  • اضبط waitlist_confirmation_mode على WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS في wait_estimate لأحجام المجموعة التي تتطلب تأكيدًا يدويًا. يجب ضبط هذه السمة في BatchGetWaitEstimateResponse وGetWaitlistEntryResponse.
  • يجب أن تكون بيانات إدخالات قائمة الانتظار التي طلبها المستخدم ولكن لم يقبلها التاجر بعد في الحالة PENDING_MERCHANT_CONFIRMATION.

حالات اختبار قوائم الانتظار في الحجوزات

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

استرداد مدة الانتظار

  • يتم عرض تقديرات الانتظار لكل حجم مجموعة مطلوب في BatchGetWaitEstimatesRequest.
  • بالنسبة إلى أحجام الحفلات التي يتمكّن التاجر من قبول أو رفض إضافات قوائم الانتظار الجديدة، يجب ضبط وضع الانتظار على السمة WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS.

إنشاء المشاركات في قائمة الانتظار

  • يمكن إنشاء إدخال في قائمة الانتظار من خلال طلب CreateWaitlistEntry.
  • في حال تعذّر إنشاء إدخال قائمة الانتظار، سيظهر خطأ في منطق النشاط التجاري في الرد.
  • إذا نجحت محاولة CreateWaitlistEntry، سيتم عرض الاستجابة نفسها عند استلام الرسالة CreateWaitlistEntry نفسها مرة أخرى.
  • إذا تعذّرت محاولة CreateWaitlistEntry، يُعيد الخادم المحاولة عند استلام الرسالة CreateWaitlistEntry نفسها مرة أخرى.
  • تظهر الإدخالات في قائمة الانتظار على واجهة التاجر.
  • تؤدي المكالمات الواردة إلى GetWaitlistEntry إلى إرجاع إدخال قائمة الانتظار الذي تم إنشاؤه بنجاح.

حالات دخول قائمة الانتظار والطوابع الزمنية

  • تأكَّد من عرض كل حالة إدخال في قائمة الانتظار بشكل صحيح في إدخال قائمة الانتظار لردود GetWaitlistEntry.
  • تأكَّد من ضبط كل طابع زمني لولاية في حقل الطابع الزمني المناسب لإدخال قائمة الانتظار في ردود GetWaitlistEntry.

حذف إدخال قائمة الانتظار

  • يمكن حذف الإدخالات الحالية في قائمة الانتظار. يجب أن تكون الاستجابة للحذف الناجح هي النموذج الأولي الفارغ {}.

إيقاف

نموذج خلاصة خدمة قائمة الانتظار (JSON)

خلاصة خدمة قائمة الانتظار

إيقاف الميزة لدى التاجر

وتتوقّع Google تلقّي ردود معيّنة من التجّار الذين سبق لهم تفعيل قوائم الانتظار ولكنهم قرّروا إيقافها.

الإيقاف الفوري

الإيقاف الموسّع

  • أزِل waitlist_rules من خلاصة الخدمة للتاجر إذا كان التاجر لا يوقف الحجوزات.
  • أزِل التاجر من خلاصة التاجر في حال إيقاف جميع عمليات الدمج مع Google.
التالي
Step 1: Setup