نمای کلی

شرکای شرکت کننده در برنامه لیست انتظار رزرواسیون باید تنظیمات حساب را قبل از شروع انجام دهند. با این حال، برخی از مراحل در راهنمای کلی برای استفاده از ویژگی لیست انتظار ضروری نیست. دستورالعمل های این صفحه توضیح می دهد که چه مراحلی برای شرکای علاقه مند به استفاده از ویژگی لیست انتظار در رزرو با Google اعمال می شود. پیشنهاد می کنیم قبل از انجام مراحل ادغام، این نمای کلی را مطالعه کنید.

فرآیند راه اندازی

شکل 1 روند راه‌اندازی بازرگانان دارای لیست انتظار شما را در مرکز اقدامات نشان می‌دهد.

به طور کلی، جریان اصلی داده بین شما (شریک) و Google در شکل 2 نشان داده شده است:

دستورالعمل‌هایی برای همه شرکای فهرست انتظار رزرواسیون

هنگام اجرای ویژگی لیست انتظار رزرواسیون، موارد زیر را در نظر داشته باشید:

• خدمات مربوط به هر تاجر لیست انتظار رزرواسیون باید waitlist_rules پر شده داشته باشد.
  • هم برای لیست انتظار و هم برای رزرو باید از یک سرویس استفاده کنید. به عبارت دیگر، اگر رستوران شما اجازه رزرو را نیز می‌دهد، فقط ابرداده مربوط به لیست انتظار را برای رزرو به سرویس اضافه کنید.
• ارسال به روز رسانی SMS برای اجرای لیست انتظار در موارد زیر ضروری است:
  • برای تأیید اینکه کاربر با موفقیت به لیست انتظار ملحق شده است.
  • تا به کاربر اطلاع دهد که جدول او آماده است.
  • برای اطلاع دادن به کاربر مبنی بر لغو لیست انتظار وی.
• پیام های اس ام اس باید حاوی پیوندی به صفحه ای باشد که در آن کاربران می توانند وضعیت لیست انتظار خود را مشاهده کنند.
• تاجرانی که فقط فهرست انتظار هستند نیازی به ارائه فیدهای در دسترس به مرکز اقدامات ندارند.
• سرور رزرو شما باید تمام مراحل خاص لیست انتظار فهرست شده در Implement the booking server را اجرا کند. شرکایی که از رزرو و لیست انتظار پشتیبانی می کنند، می توانند روش های جدید را به سرور رزرو موجود خود اضافه کنند.
• مرکز اقدامات مجموعه‌ای از موارد آزمایشی را برای روش‌های فهرست انتظار در سرور رزرو اجرا می‌کند.

نمودار جریان وضعیت

این نمودار وضعیت‌هایی را توضیح می‌دهد که باید در WaitlistEntry.waitlist_entry_state هنگام پاسخ به تماس‌های GetWaitlistEntry گزارش شوند. نمودار همچنین زمان ضبط و پر کردن فیلدهای WaitlistEntry.waitlist_entry_state_times.*_time_seconds و زمان ارسال پیامک به کاربر را نشان می دهد تا به او اطلاع دهد که وضعیت جدیدی را وارد کرده است.

موارد لبه رایج

موارد زیر موارد لبه رایج در ادغام لیست انتظار رزروها و راه حل های ترجیحی برای آنها هستند.

• اگر برخی از اندازه‌های مهمانی (اما نه همه) اضافه‌های فهرست انتظار جدید را نمی‌پذیرند، زیرا برای این اندازه‌های مهمانی انتظاری وجود ندارد، بازگشت WaitEstimates برای همه اندازه‌های مهمانی در پاسخ BatchGetWaitEstimates و اجازه دادن به کاربران برای پیوستن به لیست انتظار برای این اندازه‌های مهمانی بدون هیچ انتظاری است. ارجح. یک WaitLength با 0 parties_ahead_count و/یا با estimated_seat_time_range با 0 start_seconds و با 0 end_seconds برای party_size بدون انتظار برگردانید.
• اگر یک یا چند اندازه مهمانی اضافه‌های فهرست انتظار جدید را نمی‌پذیرند زیرا انتظار بیش از حد طولانی شده است، حذف WaitEstimates برای آن اندازه مهمانی در پاسخ BatchGetWaitEstimates ترجیح داده می‌شود.

این رویکردها ترجیح داده می‌شوند زیرا گزینه‌هایی را در اختیار کاربر قرار می‌دهند حتی اگر فهرست انتظار تاجر کاملاً باز نباشد.

دستورالعمل‌ها برای شرکای فقط در فهرست انتظار رزروها

اگر از سرور رزرو فقط برای لیست انتظار استفاده می شود موارد زیر را در نظر داشته باشید:

• شرکای فقط در فهرست انتظار رزرواسیون، فیدهای در دسترس را برای رزرو با Google ارائه نمی دهند.
• شرکای تنها در فهرست انتظار رزرو، روش‌های رزرو را در سرور رزرو خود پیاده‌سازی نمی‌کنند. در عوض، سرور رزرو را با دستورالعمل‌های اجرای فهرست انتظار پیاده‌سازی می‌کنید .
• شرکای فقط در فهرست انتظار رزروها با Google تماس API برقرار نمی کنند. این بدان معناست که شرکای فقط در لیست انتظار رزرواسیون نیازی به راه‌اندازی یک پروژه ابری یا ارائه آدرس ایمیل توسعه‌دهنده ندارند. نیازی به تکمیل به‌روزرسانی‌های Real-time API ندارید. با این حال، بازرگانان و فیدهای خدمات هنوز باید به مرکز اقدامات ارائه شوند.

دستورالعمل‌هایی برای شرکای که بازرگانان آنها باید به‌صورت دستی اضافه‌های فهرست انتظار را بپذیرند/رد کنند

اگر بازرگانان شما به توانایی پذیرش یا رد دستی افزوده‌های فهرست انتظار جدید از Google نیاز دارند، مراحل اضافی لازم است:

• waitlist_confirmation_mode را در wait_estimate برای اندازه‌های مهمانی که نیاز به تأیید دستی دارند، روی WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS تنظیم کنید. این باید در BatchGetWaitEstimateResponse و GetWaitlistEntryResponse تنظیم شود.
• ورودی‌های فهرست انتظار که توسط کاربر درخواست شده، اما هنوز توسط تاجر پذیرفته نشده‌اند، باید در حالت PENDING_MERCHANT_CONFIRMATION باشند.

موارد آزمایشی لیست انتظار رزروها

Google موارد استفاده زیر را برای اطمینان از عملکرد روش‌های فهرست انتظار در اجرای سرور رزرو شما آزمایش می‌کند. گوگل همچنین تأخیر را آزمایش و نظارت می کند. همه این تست ها باید قبل از راه اندازی انجام شود.

بازیابی WaitEstimate

• برآوردهای انتظار برای هر اندازه طرف درخواست شده در BatchGetWaitEstimatesRequest برگردانده می شود.
• برای اندازه‌های مهمانی که تاجر می‌تواند افزوده‌های فهرست انتظار جدید را بپذیرد یا رد کند، Waitlist_confirmation_mode را روی WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS تنظیم کنید.

ایجاد فهرست انتظار

• یک ورودی لیست انتظار را می توان از یک درخواست CreateWaitlistEntry ایجاد کرد.
• اگر ایجاد فهرست انتظار ناموفق باشد، یک خطای منطق تجاری در پاسخ ظاهر می شود.
• اگر تلاش CreateWaitlistEntry با موفقیت انجام شود، زمانی که همان CreateWaitlistEntry دوباره دریافت شد، همان پاسخ برگردانده می شود.
• اگر تلاش CreateWaitlistEntry با شکست مواجه شد، سرور با دریافت مجدد همان CreateWaitlistEntry دوباره تلاش می کند.
• ورودی‌های فهرست انتظار در واسط تاجر نشان داده می‌شوند.
• تماس های GetWaitlistEntry با موفقیت ورودی لیست انتظار ایجاد شده را برمی گرداند.

وضعیت های ورود به لیست انتظار و مهرهای زمانی

• بررسی کنید که هر وضعیت ورودی لیست انتظار به درستی در ورودی لیست انتظار پاسخ های GetWaitlistEntry برگردانده شده است.
• بررسی کنید که هر مهر زمانی در قسمت مُهر زمانی مناسب ورودی فهرست انتظار در پاسخ‌های GetWaitlistEntry تنظیم شده باشد.

حذف ورودی لیست انتظار

• ورودی های لیست انتظار موجود را می توان حذف کرد. پاسخ به یک حذف موفق باید پروتو خالی {} باشد.

انصراف دهید

• بررسی کنید که با بازرگانان انصرافی مطابق با توضیح در انصراف تاجر رفتار شود.

نمونه فید خدمات لیست انتظار (JSON)

تاجر انصراف داد

Google انتظار دارد برای بازرگانی که قبلاً لیست انتظار را فعال کرده بودند اما تصمیم به انصراف داشتند، پاسخ‌های خاصی ارائه شود.

انصراف فوری

• برای درخواست‌های BatchGetWaitEstimates CLOSED_OTHER برگردانید.
• برای درخواست‌های CreateWaitlistEntry WAITLIST_CLOSED برگردانید.
• درخواست‌های GetWaitlistEntry را برای کاربرانی که قبلاً در لیست انتظار هستند، به درستی برگردانید.

تمدید انصراف

• اگر تاجر از رزرو انصراف نمی‌دهد، waitlist_rules را از فید خدمات تاجر حذف کنید.
• اگر تاجر از همه ادغام‌های Google انصراف داد، آن را از فید تاجر حذف کنید.