Rezerwacje synchroniczne to rezerwacje, które zostały potwierdzone lub odrzucone. w czasie rzeczywistym.
Rezerwacje asynchroniczne to rezerwacje, które sprzedawca potwierdzi lub zostanie później odrzucona.
Rezerwacja jest określona jako synchroniczna lub asynchroniczna na poziom dostępności. Oznacza to również, że w przypadku danego sprzedawcy i danej usługi mogą istnieć zarówno synchroniczne, jak i asynchroniczne przedziały dostępności.
Aby wybrać właściwą implementację, zidentyfikuj najpierw kategorię Twoje zasoby reklamowe należą do:
- Włączanie tylko rezerwacji synchronicznych: Wszystkie sprzedawców i usługi są natychmiast potwierdzone.
- Włączanie rezerwacji asynchronicznych: Niektórzy lub wszystkie sprzedawcy i usługi wymagają instrukcji dla sprzedawcy z potwierdzeniem.
Asynchroniczne kryteria rezerwacji
- Zmodyfikowanie rezerwacji asynchronicznej w Centrum działań nie obsługiwane.
- Sprzedawcy powinni mieć możliwość zaakceptowania lub odrzucenia rezerwacji na stronie w systemie online partnera (np. panel gospodarza dla restauracji). Wywołuję metodę sprzedawcy w imieniu użytkownika, aby ustalić, czy akceptuje on odrzucenie rezerwacji jest niedozwolone.
- Propozycja sprzedawcy dotycząca nowego terminu rezerwacji nie jest obsługiwana. prośba o rezerwację musi zostać zaakceptowana lub odrzucona w pierwotnym stanie.
Włączanie tylko rezerwacji synchronicznych
Domyślna implementacja to rezerwacje synchroniczne. Zapytaj o zapoznaj się z dokumentacją kompleksowej integracji usługi Rezerwacje.
Włączanie rezerwacji asynchronicznej
Jeśli niektórzy lub wszyscy sprzedawcy korzystają z asynchronicznego procesu rezerwacji, należy wprowadzić następujące zmiany:
-
Tryb potwierdzenia: wszystkie reprezentacje przedziałów dostępności zawierają pole
confirmation_mode
, które opisuje, w jaki sposób dostępnych w danym przedziale czasu. Podaj wartośćconfirmation_mode
każdego przedziału dostępności dla :- W pliku danych dostępności atrybut
confirmation_mode
jest określony w poziom dostępności - W metodach interfejsu API serwera rezerwacji wartość
confirmation_mode
jest określona jako poziom przedziału - W metodach interfejsu Real-Time Updates API określony jest parametr
confirmation_mode
. na poziomie dostępności
- W pliku danych dostępności atrybut
- Stan rezerwacji: wszystkie informacje o rezerwacjach zawierają atrybut
Pole
status
, które reprezentuje stan rezerwacji. Trzy wprowadziliśmy nowe asynchroniczne wartości stanu:PENDING_CONFIRMATION
,DECLINED_BY_MERCHANT
iFAILED
. Zastosuj te nowe wartości stanu, gdy: tworzenia, odrzucania i niepowodzeń rezerwacji asynchronicznych. - Aktualizacje rezerwacji: wszystkie asynchroniczne aktualizacje stanu rezerwacji. rezerwacje powinny być zgłaszane za pomocą interfejsu Booking Notification API bookings.patch.
Poniższy diagram przedstawia sposób użycia trybu potwierdzenia i stanu rezerwacji w typowej asynchronicznej interakcji rezerwacji.
![Rysunek 1. Asynchroniczny proces rezerwacji](https://developers-dot-devsite-v2-prod.appspot.com/static/actions-center/images/enabling_async_1.png?authuser=5&hl=pl)
- ,
- Pliki danych o dostępności zostały zaktualizowane, tak aby każdy przedział dostępności trybu potwierdzenia. Ważne jest, aby umieścić te informacje w dokumencie aby umożliwić nam wyjaśnienie asynchronicznego charakteru rezerwacji użytkownik na wczesnym etapie ścieżki zakupu.
- Kiedy
BatchAvailabilityLookup
lubCheckAvailability
przechodzimy do trybu potwierdzenia i najlepiej takiego samego potwierdzenia, . Dzięki temu użytkownicy zobaczą odpowiedni komunikat. - Kiedy
CreateBooking
Przekazujemy tryb potwierdzenia i wskazywać oczekiwany tryb potwierdzenia. Gdy rezerwacja asynchroniczna gdy przesłano prośbę, rezerwacja jest zwracana ze stanemPENDING_MERCHANT_CONFIRMATION
- Gdy sprzedawca zaakceptuje lub odrzuci prośbę o rezerwację, status jest aktualizowany przez bookings.patch. Jeśli chcesz automatycznie odrzucać rezerwacje, które nie w odpowiednim czasie, korzystając z tej samej aktualizacji .
Pliki danych dostępności
W pliku danych o dostępności określ, czy każdy przedział jest synchroniczny, czy
asynchronicznie. Aby to zrobić, ustaw nowy confirmation_mode
.
// Mode by which bookings for an availability slot are confirmed. enum ConfirmationMode { // The confirmation mode was not specified. // Synchronous confirmation will be assumed. CONFIRMATION_MODE_UNSPECIFIED = 0; // Bookings for this availability will be confirmed synchronously. CONFIRMATION_MODE_SYNCHRONOUS = 1; // Bookings for this availability will be confirmed asynchronously. CONFIRMATION_MODE_ASYNCHRONOUS = 2; }
Chociaż zakłada się, że tryb potwierdzenia jest synchroniczny, jeśli żaden tryb nie jest zdecydowanie zalecamy jawne podanie trybu, ponieważ uniknąć nieporozumień związanych z przypadkowym pominięciem.
Dane asynchroniczne
{ "availability": [ { "merchant_id": "10001", "service_id": "1000", "spots_open": 3, "spots_total": 3, "duration_sec": 3600, "start_sec": 1535806800, "resources": { "party_size": 4 }, "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" } ] }
Synchronizacja
{ "availability": [ { "merchant_id": "10001", "service_id": "1000", "spots_open": 3, "spots_total": 3, "duration_sec": 3600, "start_sec": 1535806800, "resources": { "party_size": 4 }, "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" } ] }
Asynchroniczne i synchroniczne
{ "availability": [ { "merchant_id": "10001", "service_id": "1000", "spots_open": 3, "spots_total": 3, "duration_sec": 3600, "start_sec": 1535806800, "resources": { "party_size": 4 }, "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" }, { "merchant_id": "10002", "service_id": "1000", "spots_open": 4, "spots_total": 4, "duration_sec": 3600, "start_sec": 1535806800, "resources": { "party_size": 2 }, "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" } ] }
Serwer rezerwacji
BatchAvailabilitylookup lub CheckAvailability
W
BatchAvailabilityLookupResponse
(BAL)
lub
CheckAvailabilityResponse
(CA), zwraca wartość confirmation_mode
podaną w
pliku danych o dostępności i przekazywana przez tag
BatchAvailabilityLookupRequest
lub
CheckAvailabilityRequest
.
BAL-Async
{ "slot_time_availability": [ { "slot_time": { "duration_sec": "3600", "resource_ids": { "party_size": 3 }, "service_id": "1000", "start_sec": "1546458300", "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" }, "available": true } ] }
BAL – synchronizacja
{ "slot_time_availability": [ { "slot_time": { "duration_sec": "3600", "resource_ids": { "party_size": 3 }, "service_id": "1000", "start_sec": "1546458300", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" }, "available": true } ] }
CA-Async
{ "slot": { "duration_sec": "3600", "merchant_id": "317652", "resources": { "party_size": 3 }, "service_id": "1000", "start_sec": "1546458300", "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" }, "count_available": 1, "duration_requirement": "DO_NOT_SHOW_DURATION" }
Synchronizacja z urzędem certyfikacji
{ "slot": { "duration_sec": "3600", "merchant_id": "317652", "resources": { "party_size": 3 }, "service_id": "1000", "start_sec": "1546458300", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" }, "count_available": 1, "duration_requirement": "DO_NOT_SHOW_DURATION" }
CreateBooking
Pamiętaj o zwróceniu prawidłowego stanu rezerwacji, korzystając z dostępnych opcje poniżej:
// Status of a booking. // // Updating booking status does not change the status of the associated payment. // Prepayment status updates should be done using the PrepaymentStatus enum. enum BookingStatus { // Not specified. BOOKING_STATUS_UNSPECIFIED = 0; // Booking has been confirmed CONFIRMED = 1; // Booking is awaiting confirmation by the merchant before it can transition // into CONFIRMED status. Only applicable to non-payments Dining or // Beauty verticals. PENDING_MERCHANT_CONFIRMATION = 2; // Booking has been canceled on behalf of the user. // The merchant can still trigger a manual refund. CANCELED = 3; // User did not show for the appointment NO_SHOW = 4; // User did not show for the appointment in violation of the cancellation // policy. NO_SHOW_PENALIZED = 5; // Booking could not be completed by the async backend due to a failure. FAILED = 6; // Booking was asynchronously declined by the merchant. Only applicable to // non-payments Dining or Beauty verticals. DECLINED_BY_MERCHANT = 7; }
W sekcji CreateBookingResponse
zwraca bieżącą wartość confirmation_mode
dla podanego zagregowanego przedziału czasu rezerwacji
w żądaniu CreateBookingRequest. Ponadto, gdy rezerwacja jest asynchroniczna,
ustaw status
na PENDING_MERCHANT_CONFIRMATION
. Sprawdź, czy
confirmation_mode
to odpowiedź użytkownika, a element Zarezerwuj z
Google stara się nie wprowadzać użytkowników w błąd.
Dane asynchroniczne
{ "booking": { "slot": { "duration_sec": "3600", "merchant_id": "100001", "resources": { "party_size": 2 }, "service_id": "1000", "start_sec": "1546647234", "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" }, "user_information": { "email": "johnsmith@gmail.com", "family_name": "John", "given_name": "Smith", "telephone": "+1 800-123-4567", "user_id": "2017492857928759285" }, "payment_information": { "prepayment_status": "PREPAYMENT_NOT_PROVIDED" }, "status": "PENDING_MERCHANT_CONFIRMATION" } }
Synchronizacja
{ "booking": { "slot": { "duration_sec": "3600", "merchant_id": "100001", "resources": { "party_size": 2 }, "service_id": "1000", "start_sec": "1546647234", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" }, "user_information": { "email": "johnsmith@gmail.com", "family_name": "John", "given_name": "Smith", "telephone": "+1 800-123-4567", "user_id": "2017492857928759285" }, "payment_information": { "prepayment_status": "PREPAYMENT_NOT_PROVIDED" }, "status": "CONFIRMED" } }
UpdateBooking
W początkowej wersji funkcji asynchronicznej użytkownik modyfikuje dotychczasową rezerwację nie są obsługiwane. Zamiast tego użytkownik powinien anulować rezerwację i utworzyć nowa rezerwacja.
Aktualizacje w czasie rzeczywistym
Aby zobaczyć aktualizacje dostępności w czasie rzeczywistym, confirmation_mode
należy określić. Dotyczy to tych metod:
Zasoby reklamowe RTU (ReplaceServiceAvailability lub BatchReplaceServiceAvailability)
Zastosowanie
Metoda availability.replace
(zbiorcza)
lub
metoda services.availability.replace
,
ustaw confirmation_mode
na CONFIRMATION_MODE_ASYNCHRONOUS
w Availability
Dane asynchroniczne
{ "extendedServiceAvailability": [ { "merchantId": "1001", "serviceId": "12310", "startTimeRestrict": "2014-10-02T15:01:23.045123456Z", "endTimeRestrict": "2014-10-02T19:01:23.045123456Z", "availability": [ { "startTime": "2014-10-02T15:30:00.00Z", "duration": "3600s", "spotsOpen": "0", "spotsTotal": "2", "availabilityTag": "1000001", "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" } ] } ] }
Synchronizacja
{ "extendedServiceAvailability": [ { "merchantId": "1001", "serviceId": "12310", "startTimeRestrict": "2014-10-02T15:01:23.045123456Z", "endTimeRestrict": "2014-10-02T19:01:23.045123456Z", "availability": [ { "startTime": "2014-10-02T15:30:00.00Z", "duration": "3600s", "spotsOpen": "0", "spotsTotal": "2", "availabilityTag": "1000001", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" } ] } ] }
Asynchroniczne i synchroniczne
{ "extendedServiceAvailability": [ { "merchantId": "1001", "serviceId": "12310", "startTimeRestrict": "2014-10-02T15:01:23.045123456Z", "endTimeRestrict": "2014-10-02T19:01:23.045123456Z", "availability": [ { "startTime": "2014-10-02T15:30:00.00Z", "duration": "3600s", "spotsOpen": "0", "spotsTotal": "2", "availabilityTag": "1000001", "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" }, { "startTime": "2014-10-03T11:00:00.00Z", "duration": "5400s", "spotsOpen": "1", "spotsTotal": "1", "availabilityTag": "1000002", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" } ] } ] }
Interfejs API Booking Notification API
Asynchroniczne aktualizacje stanu rezerwacji należy wprowadzać za pomocą opcji Rezerwacji. Metoda bookings.patch interfejsu Notification API.
Podczas aktualizowania stanu uwzględnij nazwę pola status
w
updateMask
Stan | Opis |
---|---|
POTWIERDZONO | sprzedawca potwierdził rezerwację |
NIEPOWODZENIE | partner nie mógł potwierdzić ani odrzucić rezerwacji u sprzedawcy |
DECLINED_BY_MERCHANT | sprzedawca odrzucił rezerwację |
Request: PATCH https://mapsbooking.googleapis.com/v1alpha/notification/partners/<PARTNER_ID>/bookings/<BOOKING_ID>?updateMask=status Body: {"name":"partners/<PARTNER_ID>/bookings/<BOOKING_ID>", "status":"DECLINED_BY_MERCHANT"}
W przypadku niepowodzenia rezerwacji ustaw stan rezerwacji na FAILED
,
atrybut Reserve_failure Jeśli stan jest ustawiony na inny, parametr
Pole booking_failure
jest ignorowane.
Request: PATCH https://mapsbooking.googleapis.com/v1alpha/notification/partners/<PARTNER_ID>/bookings/<BOOKING_ID>?updateMask=status&booking_failure.cause="SLOT_UNAVAILABLE" Body: {"name":"partners/<PARTNER_ID>/bookings/<BOOKING_ID>", "status":"FAILED"}
Powiadomienia e-mail
W przypadku rezerwacji asynchronicznych jest pięć potencjalnych e-maili związanych z stanu rezerwacji wysyłanej do użytkowników.
PENDING_MERCHANT_CONFIRMATION
CONFIRMED
DECLINED_BY_MERCHANT
FAILED
CANCELED