Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Partnerzy biorący udział w programie rezerwacji z listy oczekujących muszą przed rozpoczęciem konfigurować konto. Jednak do korzystania z funkcji kolejki nie są potrzebne niektóre kroki z ogólnego przewodnika. Wytyczne na tej stronie wyjaśniają, jakie kroki należy wykonać w przypadku partnerów zainteresowanych korzystaniem z funkcji listy oczekujących w usłudze Zarezerwuj z Google. Zanim wykonasz czynności związane z integracją, przeczytaj ten ogólny opis.
Proces uruchamiania
Rysunek 1 przedstawia proces uruchamiania w Centrum działań sprzedawców, którzy zostali dodani do listy oczekujących.
Rysunek 1. Najważniejsze kroki integracji
Ogólnie główne przepływy danych między Tobą (Partnerem) a Google przedstawia rysunek 2:
Rysunek 2. Diagram przepływu danych integracji
Wytyczne dla wszystkich partnerów korzystających z list oczekujących na rezerwacje
Podczas wdrażania funkcji listy oczekujących na rezerwację pamiętaj o tych kwestiach:
Usługa dla każdego sprzedawcy z listy oczekujących musi mieć wypełnione pola waitlist_rules.
Musisz używać tej samej usługi zarówno w przypadku listy oczekujących, jak i rezerwacji. Innymi słowy, jeśli Twoja restauracja umożliwia rezerwacje, dodaj metadane dotyczące listy oczekujących do usługi rezerwacji.
Wysyłanie powiadomień SMS jest wymagane w przypadku wdrożenia listy oczekujących w tych sytuacjach:
Aby potwierdzić, że użytkownik dołączył do listy oczekujących.
Aby powiadomić użytkownika, że jego stół jest gotowy.
Ten szablon służy do powiadomienia użytkownika o anulowaniu jego pozycji na liście oczekujących.
SMS-y muszą zawierać link do strony, na której użytkownicy mogą sprawdzić swój stan na liście oczekujących.
Sprzedawcy, którzy oferują produkty tylko na liście oczekujących, nie muszą przesyłać plików danych o dostępności do Centrum działań.
Serwer rezerwacji musi realizować wszystkie kroki dotyczące listy oczekujących wymienione w artykule Wdrażanie serwera rezerwacji. Partnerzy, którzy obsługują rezerwacje i listy oczekujących, mogą dodać nowe metody do swojego dotychczasowego serwera rezerwacji.
Centrum działań uruchamia zestaw przypadków testowych dla metod kolejki oczekujących na serwerze rezerwacji.
Rysunek 3. Schemat przepływu dotyczący stanu na liście oczekujących
Typowe skrajne przypadki
Poniżej znajdziesz typowe przypadki integracji z listą oczekujących na rezerwację i preferowane rozwiązania.
Jeśli niektóre (ale nie wszystkie) rozmiary grup nie akceptują nowych wpisów na liście oczekujących, ponieważ nie ma kolejki dla tych rozmiarów grup, zaleca się zwrócenie wartości WaitEstimates dla wszystkich rozmiarów grup w odpowiedzi BatchGetWaitEstimates oraz zezwolenie użytkownikom na dołączanie do listy oczekujących dla tych rozmiarów grup bez kolejki. Zwraca WaitLength z 0 parties_ahead_count lub estimated_seat_time_range z 0 start_seconds i 0 end_seconds dla party_size bez oczekiwania
Jeśli w przypadku co najmniej 1 liczby osób nie można dodawać nowych osób na listę oczekujących, ponieważ czas oczekiwania jest zbyt długi, zaleca się pominięcie opcji WaitEstimates w przypadku tych liczb osób w odpowiedzi BatchGetWaitEstimates.
Te metody są preferowane, ponieważ dają użytkownikom możliwość wyboru, nawet jeśli lista oczekujących sprzedawcy może nie być w pełni otwarta.
Wytyczne dla partnerów, którzy korzystają tylko z list oczekujących
Jeśli serwer rezerwacji jest używany tylko do obsługi list oczekujących, pamiętaj o tych kwestiach:
Partnerzy, którzy oferują rezerwacje tylko na listach oczekujących, nie udostępniają plików danych o dostępności do Zarezerwuj z Google.
Partnerzy, którzy korzystają tylko z list oczekujących, nie implementują metod rezerwacji na serwerze rezerwacji. Zamiast tego
zaimplementuj serwer rezerwacji, korzystając z instrukcji implementacji listy oczekujących.
Partnerzy, którzy korzystają tylko z list oczekujących, nie wykonują wywołań interfejsu API do Google. Oznacza to, że partnerzy, którzy korzystają tylko z list oczekujących, nie muszą konfigurować projektu w chmurze ani podawać adresu e-mail dewelopera. Nie musisz wypełniać sekcji Aktualizacje interfejsu API w czasie rzeczywistym. Pliki danych merchant i service muszą jednak zostać przesłane do Centrum działań.
Wskazówki dla partnerów, których sprzedawcy muszą ręcznie akceptować lub odrzucać dodawanie do listy oczekujących
Jeśli Twoi sprzedawcy potrzebują możliwości ręcznego akceptowania lub odrzucania nowych próśb o dodanie do listy oczekujących przesłanych przez Google, musisz wykonać dodatkowe czynności:
Ustaw wartość waitlist_confirmation_mode na
WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS w
wait_estimate w przypadku liczby osób, która wymaga ręcznego potwierdzenia. Musi być ustawiony w BatchGetWaitEstimateResponse i GetWaitlistEntryResponse.
Wpisy na liście oczekujących, które zostały zgłoszone przez użytkownika, ale nie zostały jeszcze zaakceptowane przez sprzedawcę, powinny mieć stanPENDING_MERCHANT_CONFIRMATION.
Przypadki testowe dotyczące list oczekujących na rezerwacje
Google testuje poniższe przypadki użycia, aby zapewnić działanie metod kolejki oczekujących w implementacji serwera rezerwacji. Google testuje i monitoruje też opóźnienia. Wszystkie te testy muszą zakończyć się pomyślnie przed uruchomieniem.
Pobieranie wartości WaitEstimate
Szacowane czasy oczekiwania są zwracane dla każdego rozmiaru grupy podanego w BatchGetWaitEstimatesRequest.
W przypadku wielkości grup, które sprzedawca może zaakceptować lub odrzucić, ustaw parametr waitlist_confirmation_mode na
WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS.
Tworzenie pozycji na liście oczekujących
Wpis na liście oczekujących może zostać utworzony na podstawie prośby CreateWaitlistEntry.
Jeśli tworzenie pozycji na liście oczekujących zakończy się niepowodzeniem, w odpowiedzi pojawi się błąd logiki biznesowej.
Jeśli próba wykonania operacji CreateWaitlistEntry się powiedzie, ta sama odpowiedź zostanie zwrócona, gdy otrzymamy to samo żądanie CreateWaitlistEntry ponownie.
Jeśli próba CreateWaitlistEntry się nie powiedzie, serwer spróbuje ponownie, gdy otrzyma ten sam CreateWaitlistEntry.
Wpisy na liście oczekujących pojawiają się w interfejsie sprzedawcy.
Połączenia z adresem GetWaitlistEntry zwracają utworzony wpis na liście oczekujących.
Stany i sygnatura czasowa pozycji na liście oczekujących
Sprawdź, czy stan każdego wpisu na liście oczekujących jest prawidłowo zwracany w odpowiednich odpowiedziach GetWaitlistEntry.
Sprawdź, czy w odpowiednim polu znacznika czasu w pliku odpowiedzi GetWaitlistEntry jest ustawiony znacznik czasu dla każdego stanu.
Usuwanie pozycji z listy oczekujących
Istniejące pozycje na liście oczekujących mogą zostać usunięte. Odpowiedź na usunięty obiekt musi być pustym proto {}.
Zrezygnuj
Sprawdź, czy sprzedawcy, którzy zrezygnowali z usług, są traktowani zgodnie z opisem w sekcji Rezygnacja sprzedawcy z usług.
Przykładowy plik danych usługi z listą oczekujących (w formacie JSON)
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 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."]]
