שותפים שמשתתפים בתוכנית 'רשימת המתנה להזמנות' חייבים להשלים את הגדרת החשבון לפני שהם מתחילים. עם זאת, יש שלבים מסוימים שבמדריך הכללי שלא חייבים להשתמש בתכונה של רשימת ההמתנה. בהנחיות בדף הזה מוסבר אילו שלבים חלים על שותפים שרוצים להשתמש בתכונה 'רשימת המתנה' ב-'Google הזמנת מקומות' ב-Google. מומלץ לקרוא את הסקירה הכללית הזו לפני שמבצעים את שלבי השילוב.
תהליך הפעלה
באיור 1 מפורט התהליך להשקת מוכרים שהפעילו את רשימת ההמתנה במרכז הפעולות.
![איור 1: שלבי השילוב ברמה גבוהה](https://developers.google.cn/static/actions-center/images/waitlists/reserve_with_google_waitlist_integration.png?authuser=9&hl=he)
באופן כללי, זרימת הנתונים העיקרית בינך (השותף) לבין Google מתועדות באיור 2:
![איור 2: תרשים של זרימה של נתוני האינטגרציה](https://developers.google.cn/static/actions-center/images/waitlists/waitlist_integration_data_flow_diagram.png?authuser=9&hl=he)
הנחיות לכל השותפים ברשימות ההמתנה להזמנות
כשמטמיעים את התכונה 'רשימות המתנה', חשוב לזכור את הדברים הבאים:
- בשירות של כל מוכר ברשימת המתנה של הזמנות צריך להיות
waitlist_rules
אכלוס.- צריך להשתמש באותו שירות גם לרשימת המתנה וגם להזמנה. כלומר, אם אפשר להזמין מקום במסעדה, צריך רק להוסיף לשירות את המטא-נתונים שקשורים לרשימת ההמתנה כדי לבצע הזמנה.
- חובה לשלוח עדכונים ב-SMS כדי להטמיע את רשימת ההמתנה
במקרים הבאים:
- בדיקה אם המשתמש הצטרף לרשימת ההמתנה.
- כדי להודיע למשתמש שהטבלה שלו מוכנה.
- כדי להודיע למשתמש שההרשמה שלו לרשימת ההמתנה בוטלה.
- הודעות SMS צריכות לכלול קישור לדף שבו המשתמשים יכולים לראות את סטטוס רשימת ההמתנה שלהם.
- מוכרים שנמצאים ברשימת המתנה בלבד לא צריכים לספק פידים של זמינות למרכז הפעולות.
- צריך להטמיע בשרת ההזמנות את כל השלבים הספציפיים לרשימת ההמתנה שמפורטים במאמר הטמעת שרת ההזמנות. שותפים שתומכים גם בהזמנות וגם ברשימות המתנה יכולים להוסיף את השיטות החדשות לשרת ההזמנות הקיים שלהם.
- במרכז הפעולות מריצים קבוצה של מקרי בדיקה לשיטות של רשימת ההמתנה בשרת ההזמנות.
תרשים זרימה של סטטוס
בתרשים הזה מתוארים הסטטוסים שחייבים לדווח עליהם
WaitlistEntry.waitlist_entry_state
בתגובה לקריאות
GetWaitlistEntry
. התרשים גם מציין מתי צריך להקליט ולאכלס את השדות של
WaitlistEntry.waitlist_entry_state_times.*_time_seconds
ומתי לשלוח הודעת SMS למשתמש כדי ליידע אותו שהוא נכנס למצב חדש.
![איור 3: תרשים זרימה של סטטוס רשימת ההמתנה](https://developers.google.cn/static/actions-center/images/waitlists/waitlist_status_flowchart.png?authuser=9&hl=he)
מקרי קצה נפוצים
המקרים הבאים הם דוגמאות קצה נפוצות בשילוב של Reservations Waitlist ופתרונות מועדפים.
-
אם חלק מהגדלים (אך לא כולם) לא מקבלים הוספות חדשות
לרשימת ההמתנה מפני שאין המתנה, מומלץ להחזיר
את
WaitEstimates
לכל מספר הסועדים בתגובה ל-BatchGetWaitEstimates
, ולאפשר למשתמשים להצטרף לרשימת ההמתנה עבור מספר האנשים ללא המתנה ללא המתנה. ניתן להחזירWaitLength
עם 0parties_ahead_count
ו/או עםestimated_seat_time_range
עם 0start_seconds
ועם 0end_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.