מבוא לרשימת ההמתנה

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

תהליך השקה

באיור 1 מוסבר איך משיקים מוכרים שתומכים ברשימת המתנה ב-'Google הזמנת מקומות'.

איור 1: שלבי שילוב ברמה גבוהה
איור 1: שלבי שילוב ברמה גבוהה

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

איור 2: תרשים זרימה של נתוני השילוב
איור 2: תרשים זרימה של נתוני שילוב

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

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

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

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

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

איור 3: תרשים זרימה של סטטוס ברשימת ההמתנה
איור: 3 תרשים זרימה של סטטוס רשימת ההמתנה

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

בהמשך מפורטים מקרים נפוצים של שילוב ברשימת המתנה ופתרונות מועדפים להם.

  • אם חלק מהמפלגות (אבל לא כולן) לא מקבלות הוספות חדשות לרשימת המתנה כי אין המתנה לקבוצות האלה, היא תחזיר את 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 הזמנת מקומות'.

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

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

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

מקרי בדיקה ברשימת המתנה

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

אחזור של ממתינים להערכה

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

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

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

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

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

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

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

ביטול הסכמה

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

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

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

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

ביטול מיידי

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

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