Serwer rezerwacji gotowy

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

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

Zanim przejdziesz na aktualizacje w czasie rzeczywistym, wykonaj te czynności związane z serwerem rezerwacji:

Każde zadanie jest oznaczane jako ukończone i zmienia kolor na zielony, gdy w ramach procesu rezerwacji w środowisku testowym wysyłasz do serwera rezerwacji dokładne dane o asortymencie w czasie rzeczywistym. Kamienie milowe serwera rezerwacji są analizowane w okresie 14 dni.

Wdrażanie interfejsu API REST

Wdrażanie interfejsu API opartego na REST. Dzięki temu Google może wysyłać żądania do serwera rezerwacji przez protokół HTTPS.

Aby wdrożyć interfejs API, skonfiguruj serwer rezerwacji w środowisku deweloperskim lub w piaskownicy, który łączy się ze środowiskiem piaskownicy Centrum działań. Przejdź do środowiska produkcyjnego dopiero po pełnym przetestowaniu serwera 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 żądania HealthCheck są wysyłane do api.example.com/google/v3/HealthCheck.

Upewnij się, że w przypadku środowisk piaskownicy i produkcyjnego skonfigurowano prawidłowy punkt końcowy serwera rezerwacji za pomocą przełącznika środowisk.

Zabezpieczenia i uwierzytelnianie

Cała komunikacja z serwerem rezerwacji odbywa się za pomocą protokołu HTTPS z użyciem uwierzytelniania podstawowego. Aby ułatwić konfigurację serwera, zalecamy użycie publicznie dostępnego narzędzia do weryfikacji protokołu 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. Podstawowe informacje o uwierzytelnianiu, hasło i nazwę użytkownika serwera rezerwacji 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 środowisku piaskownicy i środowisku produkcyjnym, zapoznaj się z artykułem Konfigurowanie danych logowania serwera rezerwacji.

Każda odpowiedź serwera rezerwacji na żądanie z usługi Zarezerwuj 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
BatchAvailabilityLookup wczytanie strony

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

Ładunek zawiera wiele przedziałów czasowych na podstawie najnowszych przesłanych plików danych, które usługa Zarezerwuj z Google uznaje za dostępne.

 Odpowiedź musi zawierać każde żądanie boksu i jego aktualną dostępność. Zapobiega to wyświetlaniu niedostępnych miejsc. POST /v3/BatchAvailabilityLookup/
BatchAvailabilityLookup kliknięcie miejsca Gdy użytkownikowi zostaną wyświetlone dostępne terminy rezerwacji i kliknie on jeden z nich, wywoływane jest żądanie BatchAvailabilityLookup kliknięcia terminu. Odpowiedź musi odzwierciedlać aktualną, rzeczywistą dostępność miejsca. Jeśli przed kliknięciem przedziału czasowego zostanie on zarezerwowany, zwróć odpowiedź, że jest niedostępny. POST /v3/BatchAvailabilityLookup/
CreateBooking Gdy użytkownik potwierdzi, że chce zarezerwować wybrane okienko czasowe w oknie rezerwacji, wysyłana jest prośba CreateBooking.

Odpowiedź musi wskazywać, czy rezerwacja się powiodła.

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

Jeśli rezerwacja zostanie utworzona, odpowiedź będzie zawierać unikalny identyfikator booking_id, który będzie można wykorzystać w przyszłych żądaniach lub aktualizacjach.

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

Używaj kodu stanu HTTP, aby wskazywać stan wyświetlania serwera. Zwróć kod stanu HTTP 200, jeśli serwer jest aktywny i działa prawidłowo.

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

 GET /v3/HealthCheck/

Proces rezerwacji w piaskownicy

Aby wyświetlić proces rezerwacji w piaskownicy, otwórz widok Centrum działań – Asortyment. W kolumnie RwG - E2E widoku Zasoby reklamowe wyświetla się link Na żywo (w piaskownicy) do procesu rezerwacji w piaskownicy dla 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 – E2E, po wczytaniu strony zostanie wysłane BatchAvailabilityLookupżądanie i wyświetli się znana dostępność sprzedawcy.
  • Gdy klikniesz godzinę rezerwacji, wywołasz żądanie BatchAvailabilityLookup on slot click i wyświetlisz okno rezerwacji.
  • Dokończ rezerwację w oknie rezerwacji, aby wysłać CreateBooking.
  • Po dokonaniu rezerwacji w środowisku piaskownicy konto użyte do utworzenia rezerwacji otrzyma e-maila z potwierdzeniem i szczegółami rezerwacji.
  • Aby wywołać metodę UpdateBooking, zmień lub anuluj rezerwację z poziomu e-maila.

HealthCheck

Pamiętaj, aby zaimplementować metodę HealthCheck w piaskownicy i w środowisku produkcyjnym. Ta metoda zwraca stan serwera rezerwacji. Umożliwia to Google ciągłe monitorowanie stanu serwera rezerwacji.

Prośba: brak

Zwracana wartość: brak

Używaj kodu stanu HTTP, aby wskazywać stan wyświetlania serwera.

Jeśli serwer jest aktywny i działa prawidłowo, zwróć kod stanu HTTP 200. W przypadku błędu zwróć jeden z kodów stanu HTTP.