סקירה כללית

שותפים שמשתתפים בתוכנית 'רשימת המתנה להזמנות' חייבים להשלים את הגדרת החשבון לפני שהם מתחילים. עם זאת, יש שלבים מסוימים שבמדריך הכללי שלא חייבים להשתמש בתכונה של רשימת ההמתנה. בהנחיות בדף הזה מוסבר אילו שלבים חלים על שותפים שרוצים להשתמש בתכונה 'רשימת המתנה' ב-'Google הזמנת מקומות' ב-Google. מומלץ לקרוא את הסקירה הכללית הזו לפני שמבצעים את שלבי השילוב.

תהליך הפעלה

באיור 1 מפורט התהליך להשקת מוכרים שהפעילו את רשימת ההמתנה במרכז הפעולות.

באופן כללי, זרימת הנתונים העיקרית בינך (השותף) לבין Google מתועדות באיור 2:

הנחיות לכל השותפים ברשימות ההמתנה להזמנות

כשמטמיעים את התכונה 'רשימות המתנה', חשוב לזכור את הדברים הבאים:

• בשירות של כל מוכר ברשימת המתנה של הזמנות צריך להיות waitlist_rules אכלוס.
  • צריך להשתמש באותו שירות גם לרשימת המתנה וגם להזמנה. כלומר, אם אפשר להזמין מקום במסעדה, צריך רק להוסיף לשירות את המטא-נתונים שקשורים לרשימת ההמתנה כדי לבצע הזמנה.
• חובה לשלוח עדכונים ב-SMS כדי להטמיע את רשימת ההמתנה במקרים הבאים:
  • בדיקה אם המשתמש הצטרף לרשימת ההמתנה.
  • כדי להודיע למשתמש שהטבלה שלו מוכנה.
  • כדי להודיע למשתמש שההרשמה שלו לרשימת ההמתנה בוטלה.
• הודעות SMS צריכות לכלול קישור לדף שבו המשתמשים יכולים לראות את סטטוס רשימת ההמתנה שלהם.
• מוכרים שנמצאים ברשימת המתנה בלבד לא צריכים לספק פידים של זמינות למרכז הפעולות.
• צריך להטמיע בשרת ההזמנות את כל השלבים הספציפיים לרשימת ההמתנה שמפורטים במאמר הטמעת שרת ההזמנות. שותפים שתומכים גם בהזמנות וגם ברשימות המתנה יכולים להוסיף את השיטות החדשות לשרת ההזמנות הקיים שלהם.
• במרכז הפעולות מריצים קבוצה של מקרי בדיקה לשיטות של רשימת ההמתנה בשרת ההזמנות.

תרשים זרימה של סטטוס

בתרשים הזה מתוארים הסטטוסים שחייבים לדווח עליהם WaitlistEntry.waitlist_entry_state בתגובה לקריאות GetWaitlistEntry . התרשים גם מציין מתי צריך להקליט ולאכלס את השדות של WaitlistEntry.waitlist_entry_state_times.*_time_seconds ומתי לשלוח הודעת SMS למשתמש כדי ליידע אותו שהוא נכנס למצב חדש.

מקרי קצה נפוצים

המקרים הבאים הם דוגמאות קצה נפוצות בשילוב של Reservations Waitlist ופתרונות מועדפים.

• אם חלק מהגדלים (אך לא כולם) לא מקבלים הוספות חדשות לרשימת ההמתנה מפני שאין המתנה, מומלץ להחזיר את WaitEstimates לכל מספר הסועדים בתגובה ל-BatchGetWaitEstimates, ולאפשר למשתמשים להצטרף לרשימת ההמתנה עבור מספר האנשים ללא המתנה ללא המתנה. ניתן להחזיר WaitLength עם 0 parties_ahead_count ו/או עם estimated_seat_time_range עם 0 start_seconds ועם 0 end_seconds עבור ה-party_size ללא המתנה
• אם קבוצה אחת או יותר של אנשים לא מקבלים הוספות חדשות לרשימת המתנה בגלל שההמתנה נמשכה יותר מדי זמן, עדיף להשמיט את השדה של WaitEstimates עבור מספר האנשים האלה בתשובה של BatchGetWaitEstimates.

הגישות האלה מועדפות כי הן מספקות למשתמש אפשרויות, למרות שרשימת ההמתנה של המוכר עדיין לא פתוחה לגמרי.

הנחיות לשותפים בעלי הרשאת גישה לרשימות המתנה בלבד

חשוב לזכור את הדברים הבאים אם שרת ההזמנות משמש רק לרשימות המתנה:

• שותפים ברשימות המתנה של הזמנות בלבד לא מספקים פידים של זמינות כדי לבצע 'הזמנה דרך Google'.
• שותפים לרשימות המתנה להזמנות בלבד לא מטמיעים את שיטות ההזמנה בשרת ההזמנות שלהם. במקום זאת, צריך להטמיע את שרת ההזמנות עם ההוראות להטמעה של רשימת ההמתנה.
• שותפים לניהול רשימות המתנה בלבד לא מבצעים קריאות ל-API עבור Google. המשמעות היא ששותפים לניהול רשימת המתנה של הזמנות בלבד לא צריכים להגדיר פרויקט בענן או לספק את כתובת האימייל של המפתח. אין צורך להשלים את עדכוני ה-API בזמן אמת. עם זאת, עדיין צריך לספק למרכז הפעולות את הפידים של המוכר ושל השירות.

הנחיות לשותפים שהמוכרים שלהם חייבים לאשר או לדחות באופן ידני הוספות לרשימת המתנה

אם המוכרים שלך דורשים מ-Google לאשר או לדחות באופן ידני הוספות חדשות לרשימת המתנה, נדרשים שלבים נוספים:

• צריך להגדיר את waitlist_confirmation_mode לערך WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS בשדה wait_estimate עבור מספר אנשים שצריך לאשר ידנית. צריך להגדיר את זה ב-BatchGetWaitEstimateResponse וב-GetWaitlistEntryResponse.
• בקשות ההצטרפות לרשימת ההמתנה שהמשתמש ביקש, אבל עדיין לא אושרו על ידי המוכר, צריכות להיות בסטטוס PENDING_MERCHANT_CONFIRMATION.

מקרי בדיקה לרשימת המתנה להזמנות

Google בודקת את תרחישי השימוש הבאים כדי להבטיח את הפונקציונליות של השיטות של רשימת ההמתנה בהטמעה של שרת ההזמנות שלכם. Google גם בודקת ועוקבת אחרי זמן האחזור. כל הבדיקות האלה צריכות לעבור לפני ההשקה.

אחזור אומדן ההמתנה

• המערכת מחזירה את אומדן ההמתנה לכל גודל צד שנדרש ב-BatchGetWaitEstimatesRequest.
• כשמדובר במספר גדול של אנשים, למוכר יש אפשרות לאשר או לדחות הוספה חדשה של רשימות המתנה, צריך להגדיר את הערךwaitlist_confirmation_mode לערך WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS.

יצירת רשומה ברשימת ההמתנה

• אפשר ליצור רשומה לרשימת המתנה מבקשה של CreateWaitlistEntry.
• אם לא ניתן ליצור רשומה ברשימת ההמתנה, תופיע בתשובה שגיאת לוגיקה עסקית.
• אם הניסיון של CreateWaitlistEntry יצליח, אותה תשובה תוחזר כאשר אותה CreateWaitlistEntry תתקבל שוב.
• אם הניסיון של CreateWaitlistEntry נכשל, השרת ינסה שוב כשאותו CreateWaitlistEntry יתקבל שוב.
• רשומות רשימת ההמתנה מופיעות בממשק של המוכר.
• קריאות אל GetWaitlistEntry מחזירות בהצלחה את הרשומה שנוצרה לרשימת ההמתנה.

מצבי כניסה וחותמות זמן ברשימת ההמתנה

• צריך לוודא שכל מצבי כניסה לרשימת המתנה מוחזרים בצורה תקינה ברשומת רשימת ההמתנה של GetWaitlistEntry תגובות.
• צריך לוודא שכל חותמת זמן של מצב מוגדרת בשדה חותמת הזמן המתאים ברשומת רשימת ההמתנה בתשובות של GetWaitlistEntry.

מחיקת רשומה מרשימת ההמתנה

• ניתן למחוק רשומות קיימות ברשימת ההמתנה. התגובה למחיקה שיבוצע בהצלחה חייבת להיות הפרוטוקול הריק {}.

ביטול הסכמה

• מוודאים שהמוכרים שביטלו את הסכמתם יטופלו כפי שמתואר במאמר ביטול ההצטרפות למוכרים.

פיד שירות לדוגמה של רשימת המתנה (JSON)

פיד שירות של רשימת המתנה

ביטול הצטרפות למוכרים

Google מצפה לתגובות מסוימות למוכרים שהפעילו בעבר רשימות המתנה אבל החליטו לבטל את ההצטרפות שלהם.

ביטול הסכמה מיידי

• מחזירים את CLOSED_OTHER עבור BatchGetWaitEstimates בקשות.
• החזרה של WAITLIST_CLOSED עבור CreateWaitlistEntry בקשות.
• להחזיר בקשות GetWaitlistEntry כראוי למשתמשים שכבר נמצאים ברשימת ההמתנה.

ביטול הסכמה מורחב

• יש להסיר את הערך waitlist_rules מפיד השירות של המוכר אם המוכר לא מבטל את הסכמתו להזמנות.
• צריך להסיר את המוכר מהפיד של המוכר אם הוא ביטל את ההסכמה לכל השילובים של Google.