קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
שותפים שמשתתפים בתוכנית 'רשימות המתנה להזמנות' צריכים להשלים את הגדרת החשבון לפני שהם מתחילים. עם זאת, יש שלבים במדריך הכללי שלא נדרשים כדי להשתמש בתכונה של רשימת ההמתנה. בהנחיות שבדף הזה מוסבר אילו שלבים רלוונטיים לשותפים שרוצים להשתמש בתכונה של רשימת ההמתנה ב'Google הזמנת מקומות'. מומלץ לקרוא את הסקירה הכללית הזו לפני שמבצעים את שלבי השילוב.
תהליך ההשקה
באיור 1 מפורט התהליך להפעלת המוצרים של מוכרים שנמצאים ברשימת ההמתנה ב-Actions Center.
איור 1: שלבי הטמעה ברמה גבוהה
באופן כללי, תהליכי העברת הנתונים העיקריים בינך (השותף) לבין Google מתוארים באיור 2:
איור 2: תרשים תהליך העברת הנתונים של השילוב
הנחיות לכל השותפים בתוכנית Reservations Waitlists
כשמטמיעים את התכונה 'רשימות המתנה להזמנות', חשוב לזכור את הדברים הבאים:
צריך להשתמש באותו שירות גם לרשימת המתנה וגם להזמנה. במילים אחרות, אם במסעדה שלכם אפשר גם להזמין מקומות, פשוט מוסיפים את המטא-נתונים הקשורים לרשימת המתנה לשירות להזמנת מקומות.
שליחת עדכונים ב-SMS נדרשת להטמעת רשימת ההמתנה במקרים הבאים:
כדי לוודא שהמשתמש צורף לרשימת ההמתנה.
כדי להודיע למשתמש שהשולחן מוכן.
כדי להודיע למשתמש שהרשומה שלו ברשימת ההמתנה בוטלה.
הודעות SMS חייבות לכלול קישור לדף שבו המשתמשים יכולים לראות את סטטוס ההמתנה שלהם.
מוכרים שמשתמשים ברשימת ההמתנה בלבד לא צריכים לספק פידים של זמינות למרכז הפעולות.
שרת ההזמנות צריך ליישם את כל השלבים הספציפיים לרשימת ההמתנה שמפורטים בקטע הטמעת שרת ההזמנות. שותפים שתומכים גם בהזמנות וגם ברשימות המתנה יכולים להוסיף את השיטות החדשות לשרת ההזמנות הקיים שלהם.
ב-Actions Center פועלת קבוצה של תרחישים לדוגמה לשיטות של רשימת ההמתנה בשרת ההזמנות.
בהמשך מפורטים מקרים קיצוניים נפוצים בשילוב של רשימות המתנה להזמנות, והפתרונות המועדפים לבעיות האלה.
אם בחלק מהגדלים של קבוצות (אבל לא בכל) לא מתקבלים הוספים חדשים לרשימת ההמתנה כי אין זמן המתנה בגדלים האלה, עדיף להחזיר את הערך 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 הריק {}.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-07-26 (שעון UTC)."],[[["\u003cp\u003eThis guide explains the integration process for Reserve with Google's Waitlist feature, specifically designed for partners already familiar with Reservations.\u003c/p\u003e\n"],["\u003cp\u003ePartners need to implement waitlist-specific steps in their booking server and ensure it passes Google's test cases before launching.\u003c/p\u003e\n"],["\u003cp\u003eSMS updates for confirmations, table readiness, and cancellations are mandatory, including a link for users to check their waitlist status.\u003c/p\u003e\n"],["\u003cp\u003eIntegration typically requires 12-14 weeks with dedicated technical resources, and partners should be prepared for common edge cases and merchant opt-out scenarios.\u003c/p\u003e\n"],["\u003cp\u003eWhile Reservations partners need to add waitlist metadata to existing services, Waitlist-only partners don't need to provide availability feeds or implement reservation methods.\u003c/p\u003e\n"]]],["Partners in the Reservations Waitlists program must complete account setup. Key actions include populating `waitlist_rules` in the service feed, implementing a booking server with waitlist-specific steps, and sending SMS updates for waitlist confirmations, table readiness, and cancellations. Waitlist-only merchants do not require availability feeds or reservation methods. Manual accept/reject requires setting `waitlist_confirmation_mode`. Google tests wait estimate retrieval, waitlist entry creation/deletion, status reporting and opt out responses, all of which must pass prior to launch.\n"],null,["# Overview\n\n| **Note:** This section is only relevant for partners completing Reservations Waitlists integration.\n\nPartners participating in the Reservations Waitlists program must complete the account\n[Setup](/actions-center/verticals/reservations/waitlists/integration-steps/setup) before\nthey begin. However, some steps in the general guide aren't necessary for\nuse of the waitlist feature. The guidelines on this page explain what steps\napply to partners interested in using the waitlist feature on Reserve with\nGoogle. We suggest that you read through this overview before going through\nthe integration steps.\n\nLaunch process\n--------------\n\nFigure 1 outlines the process to launch your waitlist-enabled merchants\non the Actions Center.\n| **Note:** Integration typically takes 12-14 weeks with dedicated technical resources.\n**Figure 1:** High-level integration steps\n\nOverall, the major data flows between you (the Partner) and Google are\ncaptured in Figure 2:\n**Figure 2:** Integration data flow diagram\n\nGuidelines for all Reservations Waitlists partners\n--------------------------------------------------\n\nKeep the following in mind as you implement the Reservations Waitlists feature:\n\n- The service for every Reservations Waitlists merchant must have [`waitlist_rules` populated](/actions-center/verticals/reservations/waitlists/reference/feeds/services-feed).\n - You must use the same service for both waitlist and reservation. In other words, if your restaurant also allows reservations, just add the waitlist related metadata to the service for reservation.\n- Sending out SMS updates is required for the waitlist implementation in the following cases:\n - To confirm the user has successfully joined the waitlist.\n - To notify the user that their table is ready.\n - To notify the user that their waitlist entry has been cancelled.\n- SMS messages must contain a link to a page where users can view their waitlist status.\n- Waitlist-only merchants do not need to provide availability feeds to the Actions Center.\n- Your booking server must implement all the waitlist-specific steps listed in [Implement the booking server](/actions-center/verticals/reservations/waitlists/integration-steps/implement-waitlist-booking-server). Partners that support both reservations and waitlists can add on the new methods to their existing booking server.\n- The Actions Center runs a set of [test cases](/actions-center/verticals/reservations/waitlists/integration-steps/overview#test-cases) for the waitlist methods in the booking server.\n\n### Status flowchart\n\n\nThis chart describes the statuses that must be reported in\n[`WaitlistEntry.waitlist_entry_state`](/actions-center/verticals/reservations/waitlists/reference/booking-server-api-rest/e2e-definitions/waitlistentry-definition) when responding to\n[`GetWaitlistEntry`](/actions-center/verticals/reservations/waitlists/reference/booking-server-api-rest/e2e-methods/getwaitlistentry-method) calls. The chart also indicates when to record and populate the\n[`WaitlistEntry.waitlist_entry_state_times.*_time_seconds`](/actions-center/verticals/reservations/waitlists/reference/booking-server-api-rest/e2e-definitions/waitlistentry-definition) fields and when to send an SMS to the user to inform them they have entered a new state.\n**Figure: 3** Waitlist status flowchart\n\n### Common edge cases\n\nThe following are common edge cases in a Reservations Waitlists integration and preferred\nsolutions for them.\n\n- If some (but not all) party sizes are not accepting new waitlist additions because there is no wait on these party sizes then returning `WaitEstimates` for all party sizes in the `BatchGetWaitEstimates` response and allowing users to join the waitlist for these party sizes with no wait is preferred. Return a `WaitLength` with 0 `parties_ahead_count` and/or with an `estimated_seat_time_range` with 0 `start_seconds` and with 0 `end_seconds` for the `party_size`s with no wait\n- If one or more party sizes are not accepting new waitlist additions because the wait has become too long then omitting `WaitEstimates` for those party sizes in the `BatchGetWaitEstimates` response is preferred.\n\nThese approaches are preferred since they give the user options even though\nthe merchant's waitlist may not be fully open.\n\nGuidelines for Reservations Waitlists-only partners\n---------------------------------------------------\n\nKeep the following in mind if the booking server is used only for\nwaitlists:\n\n- Reservations Waitlists-only partners don't provide availability feeds to Reserve with Google.\n- Reservations Waitlists-only partners do not implement the reservation methods in their booking server. Instead, you [Implement the booking server](/actions-center/verticals/reservations/waitlists/integration-steps/implement-waitlist-booking-server) with the instructions for the Waitlist implementation.\n- Reservations Waitlists-only partners do not make API calls to Google. This means that Reservations Waitlists-only partners do not need to set up a cloud project or provide a developer email address. You do not need to complete [Real-time API updates](/actions-center/verticals/reservations/waitlists/integration-steps/real-time-api-updates). However, [merchant](/actions-center/verticals/reservations/waitlists/reference/feeds/merchants-feed) and [service](/actions-center/verticals/reservations/waitlists/reference/feeds/services-feed) feeds still need to be provided to the Actions Center.\n\nGuidelines for partners whose merchants must\nmanually accept/reject waitlist additions\n--------------------------------------------------------------------------------------\n\nIf your merchants require the ability to manually accept or reject new\nwaitlist additions from Google, extra steps are required:\n\n- Set the `waitlist_confirmation_mode` to `WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS` in the `wait_estimate` for party sizes which require manual confirmation. This must be set in the [`BatchGetWaitEstimateResponse`](/actions-center/verticals/reservations/waitlists/reference/booking-server-api-rest/e2e-methods/batchgetwaitestimates-method) and the [`GetWaitlistEntryResponse`](/actions-center/verticals/reservations/waitlists/reference/booking-server-api-rest/e2e-methods/getwaitlistentry-method).\n- Waitlist entries that have been requested by the user, but not yet accepted by the merchant should be in state `PENDING_MERCHANT_CONFIRMATION`.\n\nReservations Waitlists test cases\n---------------------------------\n\nGoogle tests the following use cases to ensure the functionality of the\nwaitlist methods in your booking server implementation. Google also tests and\nmonitors latency. All of these tests must pass prior to launch.\n\n### WaitEstimate retrieval\n\n- Wait estimates are returned for each party size requested in a `BatchGetWaitEstimatesRequest`.\n- For party sizes which the merchant has the option to accept or reject new waitlist additions, set waitlist_confirmation_mode to `WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS`.\n\n### Waitlist entry creation\n\n- A waitlist entry can be created from a `CreateWaitlistEntry` request.\n- If waitlist entry creation fails, a business logic error shows up in the response.\n- If a `CreateWaitlistEntry` attempt succeeds, the same response is returned when the same `CreateWaitlistEntry` is received again.\n- If a `CreateWaitlistEntry` attempt fails, the server retries when the same `CreateWaitlistEntry` is received again.\n- Waitlist entries show up in the merchant's interface.\n- Calls to `GetWaitlistEntry` successfully return the created waitlist entry.\n\n### Waitlist entry states and timestamps\n\n- Verify that each waitlist entry state is returned properly in the waitlist entry of `GetWaitlistEntry` responses.\n- Verify that each state timestamp is set in the appropriate timestamp field of the waitlist entry in `GetWaitlistEntry` responses.\n\n### Waitlist entry deletion\n\n- Existing waitlist entries can be deleted. The response to a successful delete must be the empty proto `{}`.\n\n### Opt out\n\n- Verify that opted out merchants are treated as described in [Merchant opt out](/actions-center/verticals/reservations/waitlists/integration-steps/overview#merchant-opt-out).\n\nSample waitlist service feed (JSON)\n-----------------------------------\n\n[Waitlist service feed](/actions-center/verticals/reservations/waitlists/reference/feeds/services-feed)\n\nMerchant opt out\n----------------\n\nGoogle expects certain responses for merchants that previously had waitlists\nenabled but have decided to opt out.\n\n### Immediate opt out\n\n- Return [`CLOSED_OTHER`](/actions-center/verticals/reservations/waitlists/reference/booking-server-api-rest/e2e-definitions/waitlistbusinesslogicfailure-definition) for [`BatchGetWaitEstimates`](/actions-center/verticals/reservations/waitlists/reference/booking-server-api-rest/e2e-methods/batchgetwaitestimates-method) requests.\n- Return [`WAITLIST_CLOSED`](/actions-center/verticals/reservations/waitlists/reference/booking-server-api-rest/e2e-definitions/waitlistbusinesslogicfailure-definition) for [`CreateWaitlistEntry`](/actions-center/verticals/reservations/waitlists/reference/booking-server-api-rest/e2e-methods/createwaitlistentry-method) requests.\n- Return [`GetWaitlistEntry`](/actions-center/verticals/reservations/waitlists/reference/booking-server-api-rest/e2e-methods/getwaitlistentry-method) requests properly for users who are already on the waitlist.\n\n### Extended opt out\n\n- Remove the `waitlist_rules` from the service feed for the merchant if the merchant is not opting out of reservations.\n- Remove the merchant from the merchant feed if they opt out of all Google integrations."]]
