סקירה כללית

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

תהליך ההשקה

באיור 1 מפורט התהליך להפעלת המוצרים של מוכרים שנמצאים ברשימת ההמתנה ב-Actions Center.

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

הנחיות לכל השותפים בתוכנית Reservations Waitlists

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

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

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

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

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

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

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

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

הנחיות לשותפים שמשתמשים רק ב-Reservations Waitlists

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

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

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

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

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

מקרי בדיקה של Reservations Waitlists

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

אחזור של WaitEstimate

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

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

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

מצבים וחותמות זמן של רשומות ברשימת ההמתנה

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

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

• אפשר למחוק רשומות קיימות ברשימת ההמתנה. התשובה למחיקה מוצלחת חייבת להיות ה-proto הריק {}.

ביטול ההסכמה

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

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

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

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

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

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

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

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

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