Serwer rezerwacji gotowy

Aby Centrum działań mogło w Twoim imieniu wykonywać wywołania zwrotne w celu tworzenia i aktualizowania rezerwacji, potrzebujesz serwera rezerwacji. Dzięki temu Centrum działań może w imieniu użytkownika tworzyć terminy, rezerwacje i rezerwacje.

Aby dowiedzieć się, jak skonfigurować połączenie z serwerami rezerwacji w piaskownicy i środowisku produkcyjnym , przeczytaj artykuł Konfigurowanie danych logowania serwera rezerwacji.

Zanim przejdziesz do aktualizacji w czasie rzeczywistym, wykonaj te zadania związane z serwerem rezerwacji:

Gdy wysyłasz dokładne informacje o asortymencie w czasie rzeczywistym do żądań serwera rezerwacji za pomocą procesu rezerwacji w piaskownicy, każde zadanie jest oznaczane jako ukończone i zmienia kolor na zielony. Kamienie milowe serwera rezerwacji są analizowane przez 14 dni.

Implementowanie interfejsu API REST

Zaimplementuj interfejs API oparty na REST. Dzięki temu Google może wysyłać żądania serwera rezerwacji przez HTTPS.

Aby zaimplementować interfejs API, skonfiguruj serwer rezerwacji w środowisku programistycznym lub piaskownicy, który łączy się ze środowiskiem piaskownicy Centrum działań. Do środowiska produkcyjnego przejdź dopiero po pełnym przetestowaniu serwera w piaskownicy.

Wszystkie żądania serwera rezerwacji Google są względne w stosunku do adresu URL serwera rezerwacji ustawionego na stronie Serwer rezerwacji. Jeśli na przykład adres URL jest ustawiony na api.example.com/google, wszystkie HealthCheck żądania są wysyłane na adres api.example.com/google/v3/HealthCheck.

Upewnij się, że za pomocą przełącznika środowiska skonfigurowano prawidłowy punkt końcowy serwera rezerwacji zarówno w piaskownicy, jak i w środowisku produkcyjnym.

Zabezpieczenia i uwierzytelnianie

Cała komunikacja z serwerem rezerwacji odbywa się przez HTTPS z użyciem uwierzytelniania podstawowego. Aby ułatwić konfigurację serwera, zalecamy użycie publicznie dostępnego narzędzia do weryfikacji SSL lub TLS, takiego jak test serwera SSL firmy Qualys.

Wszystkie żądania wysyłane przez Google do serwera rezerwacji są uwierzytelniane za pomocą uwierzytelniania podstawowego HTTPS. Informacje o uwierzytelnianiu podstawowym serwera rezerwacji, hasło i nazwę użytkownika możesz wpisać na stronie konfiguracji serwera rezerwacji w Centrum działań. Dane logowania należy zmieniać co 6 miesięcy.

Tworzenie serwera rezerwacji

Serwer rezerwacji określa, w jaki sposób integracja komunikuje się z Twoim systemem oraz tworzy i aktualizuje rezerwacje. Aby skonfigurować połączenie z serwerami rezerwacji w piaskownicy i środowisku produkcyjnym, przeczytaj artykuł Konfigurowanie danych logowania serwera rezerwacji.

Każda odpowiedź serwera rezerwacji na żądanie z funkcji Rezerwuj z Google powinna zawierać dokładne informacje o asortymencie w czasie rzeczywistym. W tabeli poniżej znajdziesz metody dla każdej implementacji oraz linki do formatów protokołu usługi:

Metoda Definicja Odpowiedź Żądanie HTTP
Wczytanie strony BatchAvailabilityLookup

Gdy użytkownik kliknie Zarezerwuj stolik u Twojego sprzedawcy, podczas wczytywania strony zostanie wywołane żądanie BatchAvailabilityLookup.

Ładunek zawiera wiele miejsc, które są oparte na najnowszych przesłanych plikach danych i które funkcja Rezerwuj z Google uznaje za dostępne.

 Odpowiedź musi zawierać każde żądanie miejsca i jego aktualną dostępność. Zapobiega to wyświetlaniu niedostępnych miejsc. POST /v3/BatchAvailabilityLookup/
Kliknięcie miejsca BatchAvailabilityLookup Gdy użytkownik zobaczy dostępne miejsca do rezerwacji i kliknie miejsce, zostanie wywołane żądanie BatchAvailabilityLookup dotyczące kliknięcia miejsca. Odpowiedź musi odzwierciedlać aktualną dostępność miejsca. Jeśli miejsce zostało zarezerwowane przed kliknięciem, zwróć odpowiedź, że jest niedostępne. POST /v3/BatchAvailabilityLookup/
CreateBooking Gdy użytkownik potwierdzi, że chce zarezerwować wybrane miejsce w oknie rezerwacji, zostanie wysłane żądanie CreateBooking.

Odpowiedź musi odzwierciedlać powodzenie lub niepowodzenie rezerwacji.

Jeśli rezerwacja się nie powiodła, musisz podać konkretny powód niepowodzenia. Na przykład miejsce zostało zarezerwowane, zanim wywołano odpowiedź CreateBooking.

Jeśli rezerwacja została utworzona, odpowiedź zawiera unikalny booking_id umożliwiający odwoływanie się do rezerwacji w przyszłych żądaniach lub aktualizacjach.

 POST /v3/CreateBooking/
UpdateBooking Po dokonaniu rezerwacji za pomocą funkcji Rezerwuj z Google użytkownik może ją zmienić. Gdy użytkownik zaktualizuje lub anuluje rezerwację, zostanie wysłane żądanie UpdateBooking. Podobnie jak w przypadku odpowiedzi CreateBooking, odpowiedź na żądanie UpdateBooking musi odzwierciedlać powodzenie rezerwacji lub podawać konkretny powód niepowodzenia. POST /v3/UpdateBooking/
HealthCheck Centrum działań regularnie wywołuje serwer rezerwacji, aby potwierdzić, że infrastruktura jest aktywna i działa.

Użyj kodu stanu HTTP, aby wskazać stan serwera. Jeśli serwer jest aktywny i działa prawidłowo prawidłowo, zwróć kod stanu HTTP 200.

Aby wskazać błąd lub tymczasowo wyłączyć integrację, zwróć odpowiedni kod stanu HTTP inny niż 2xx .

 GET /v3/HealthCheck/

Kryteria kamieni milowych

Aby osiągnąć kamień milowy „Serwer rezerwacji gotowy”, integracja musi spełniać te kryteria w piaskownicy i środowisku produkcyjnym:

Metoda Wymagana liczba żądań (piaskownica) Wymagana liczba żądań (środowisko produkcyjne) Wymagany współczynnik powodzenia
Wczytanie strony BatchAvailabilityLookup 20 20 90%
Kliknięcie miejsca BatchAvailabilityLookup 20 20 90%
CreateBooking 10 3 90%
UpdateBooking 10 3 90%

Proces rezerwacji w piaskownicy

Aby wyświetlić proces rezerwacji w piaskownicy, otwórz widok asortymentu w Centrum działań. W kolumnie RwG – kompleksowo w widoku asortymentu wyświetla się link Aktywny (w piaskownicy) do procesu rezerwacji w piaskownicy w przypadku sprzedawców w piaskownicy, którzy są dopasowani i mają dostępność w przyszłości.

Oto działania w procesie rezerwacji:

  • Gdy klikniesz link RwG – kompleksowo, podczas wczytywania strony zostanie wywołane żądanie BatchAvailabilityLookup i wyświetli się znana dostępność sprzedawcy.

  • Gdy klikniesz godzinę rezerwacji, zostanie wywołane żądanie BatchAvailabilityLookup dotyczące kliknięcia miejsca i wyświetli się okno rezerwacji.

  • Aby wysłać żądanie CreateBooking, dokończ rezerwację w oknie rezerwacji.

  • Po dokonaniu rezerwacji w środowisku piaskownicy na konto użyte do utworzenia rezerwacji zostanie wysłany e-mail z potwierdzeniem i szczegółami rezerwacji.

  • Aby wywołać metodę UpdateBooking, zmień lub anuluj rezerwację w e-mailu.

HealthCheck

Zaimplementuj metodę HealthCheck w piaskownicy i środowisku produkcyjnym. Ta metoda zwraca stan serwera rezerwacji. Umożliwia Google ciągłe monitorowanie stanu serwera rezerwacji.

Żądanie: brak

Zwracana wartość: brak

Użyj kodu stanu HTTP, aby wskazać stan serwera.

Jeśli serwer jest aktywny i działa prawidłowo, zwróć kod stanu HTTP 200, aby wskazać błąd, zwróć jeden z kodów stanu HTTP.