Aktualizacje w czasie rzeczywistym są gotowe

Zasoby w Twoim systemie zmieniają się z powodu nowych rezerwacji, anulowań i zmian harmonogramu wprowadzanych przez sprzedawców. Interfejs Real-Time Update (RTU) API to mechanizm powiadamiania Google o tych zmianach i zmianach wprowadzonych w istniejących rezerwacjach.

RTU są wymagane w tych przypadkach:

  • Gdy użytkownik anuluje rezerwację w Twoim systemie, a miejsce staje się dostępne.
  • Gdy użytkownik zarezerwuje miejsce za pomocą Centrum działań, a przedział czasowy nie będzie już dostępny.
  • Gdy rezerwacja dokonana za pomocą Centrum działań zostanie anulowana po Twojej stronie. Przykładem takiej sytuacji jest anulowanie przez sprzedawcę bezpośrednio. Musisz zaktualizować rezerwację i dostępność, ponieważ pierwotny przedział czasowy jest teraz dostępny.

Zanim przejdziesz do weryfikacji w środowisku piaskownicy, wykonaj to zadanie związane z osiągnięciem RTU:

Każde zadanie jest oznaczane jako ukończone i zmienia kolor na zielony, gdy w ciągu 14 dni w ostatnich 20 żądaniach nie wystąpią żadne błędy. Nadal wysyłaj prawidłowe żądania, aby utrzymać zielony kolor kamienia milowego.

Interfejs API RTU i pliki danych

Interfejsy API RTU powiadamiają Google w czasie rzeczywistym o stopniowych zmianach dostępności zasobów reklamowych i rezerwacji. Oprócz RTU wysyłaj codziennie pełne pliki danych o dostępności. Dzięki temu Google będzie mieć najbardziej aktualne i dokładne informacje o dostępności, które są dostępne w Twoim systemie. Pełne pliki danych działają jak migawka najnowszego stanu dostępności asortymentu w Twoim systemie.

Więcej informacji znajdziesz w tych materiałach:

Użyj API

Projekt Google Cloud umożliwia dostęp do interfejsu Maps Booking API w Centrum działań, za pomocą którego przesyłasz jednostki RTU. Musisz użyć konta Google w konsoli Google Developers i podać numer projektu w Google Cloud na etapie konfiguracji w planie wprowadzania. Więcej informacji o włączaniu interfejsów Cloud API znajdziesz w artykule Włączanie interfejsów Cloud API.

Korzystanie z wywołań RESTful lub pobieranie biblioteki klienta

Zalecamy wykonywanie wywołań REST bezpośrednio do interfejsu Maps Booking API za pomocą ładunków JSON. Więcej informacji znajdziesz w dokumentacji interfejsu API REST.

Do łączenia się z interfejsem API możesz też używać bibliotek klienta.

.
Język Link do pobrania
Java Biblioteka klienta Java Więcej informacji znajdziesz w instrukcjach dotyczących klienta Java.

Dodatkowe biblioteki pomocy, które obsługują autoryzację i inne aspekty wywołań interfejsów API Google, są dostępne do pobrania. Więcej informacji znajdziesz w sekcji Przykłady kodu.

Pobieranie dokumentu opisującego

W przypadku niektórych bibliotek klienta, np. Ruby, konieczne jest pobranie dokumentu Discovery interfejsu API, który opisuje jego metody i parametry.

Aby pobrać dokument Discovery, użyj tego polecenia:

curl -s -o mapsbooking_rest

https://mapsbooking.googleapis.com/$discovery/rest?version=v1alpha

Więcej informacji o tym, jak uzyskać dostęp do interfejsu API z poziomu języka Ruby, znajdziesz w sekcjach Klient interfejsu API Ruby i Biblioteka uwierzytelniania Ruby.

Wykonywanie autoryzowanych wywołań interfejsu API

Podczas wywoływania interfejsu API zapoznaj się z sekcją Przygotowywanie się do wykonania wywołania interfejsu API z delegowaniem, aby autoryzować konto usługi za pomocą klucza prywatnego i tego zakresu OAuth:

https://www.googleapis.com/auth/mapsbooking

Punkty końcowe piaskownicy i środowiska produkcyjnego

Za pomocą interfejsu API możesz dzwonić zarówno w środowisku piaskownicy, jak i w środowisku produkcyjnym. Upewnij się, że oba interfejsy API są włączone w projekcie Google Cloud. Oba interfejsy API korzystają z tego samego zakresu, ale mają różne punkty końcowe.

Punkt końcowy produkcji: https://mapsbooking.googleapis.com/

Punkt końcowy piaskownicy: https://partnerdev-mapsbooking.googleapis.com/

Oto przykład w języku Java, który pokazuje, jak przełączać punkty końcowe:

 // This block of code is for OAuth and is the same for prod and sandbox.
    GoogleCredential
      .fromStream(new FileInputStream(...))
      .createScoped(Collections.singleton("https://www.googleapis.com/auth/mapsbooking"))

    // This block of code sets the endpoint. This is what you'd change to connect to the sandbox.
    new GoogleMapsBookingAPI.Builder(...)
      .setApplicationName(...)
      .setRootUrl("https://partnerdev-mapsbooking.googleapis.com/") // you add this to change the endpoint to use partnerdev.
      .build()