Buchungsserver bereit

Sie benötigen einen Buchungsserver, damit das Actions Center Rückrufe ausführen kann, um Buchungen in Ihrem Namen zu erstellen und zu aktualisieren. Damit können über das Actions Center im Namen des Nutzers Termine, Buchungen und Reservierungen bei dir erstellt werden.

Informationen zum Konfigurieren der Verbindung zu Ihren Sandbox- und Produktionsbuchungsservern finden Sie unter Anmeldedaten für Buchungsserver konfigurieren.

Führen Sie die folgenden Aufgaben aus, bevor Sie zu Echtzeitupdates wechseln:

Jede Aufgabe wird als abgeschlossen markiert und grün, wenn Sie über den Sandbox-Buchungsablauf genaue Inventardetails in Echtzeit an Booking Server-Anfragen senden. Die Meilensteine des Buchungsservers werden über einen Zeitraum von 14 Tagen analysiert.

REST API-Schnittstelle implementieren

Implementiere eine REST API-Schnittstelle, damit Google Buchungsserveranfragen über HTTPS senden kann.

Wenn Sie eine API-Schnittstelle implementieren möchten, richten Sie einen Entwicklungs- oder Sandbox-Buchungsserver ein, der mit der Actions Center-Sandbox-Umgebung verbunden ist. Wechseln Sie erst zu einer Produktionsumgebung, nachdem der Sandbox-Server vollständig getestet wurde.

Alle Buchungsserveranfragen von Google beziehen sich auf die Buchungsserver-URL, die auf der Seite Buchungsserver festgelegt ist. Wenn Ihre URL beispielsweise auf api.example.com/google festgelegt ist, werden alle HealthCheck-Anfragen an api.example.com/google/v3/HealthCheck gesendet.

Achten Sie darauf, dass für die Sandbox- und die Produktionsumgebung mit der Umgebungsauswahl der richtige Buchungsserver-Endpunkt konfiguriert ist.

Sicherheit und Authentifizierung

Die gesamte Kommunikation mit Ihrem Buchungsserver erfolgt über HTTPS mit Basisauthentifizierung. Wir empfehlen dir, bei der Einrichtung deines Servers ein öffentlich verfügbares SSL- oder TLS-Verifizierungstool zu verwenden, z. B. SSL Server Test von Qualys.

Alle Anfragen, die Google an Ihren Buchungsserver sendet, werden über die HTTPS-Basisauthentifizierung authentifiziert. Die Informationen zur Basisauthentifizierung, das Passwort und den Nutzernamen Ihres Buchungsservers können Sie auf der Konfigurationsseite für Buchungsserver im Actions Center eingeben. Anmeldedaten müssen alle sechs Monate geändert werden.

Buchungsserver erstellen

Der Buchungsserver bestimmt, wie die Integration mit Ihrem System kommuniziert und Buchungen vornimmt oder aktualisiert. Informationen zum Konfigurieren der Verbindung zu Ihren Sandbox- und Produktionsbuchungsservern finden Sie unter Anmeldedaten für Buchungsserver konfigurieren.

Jede Antwort, die Ihr Buchungsserver auf eine Anfrage von „Mit Google reservieren“ gibt, muss genaue Inventardetails in Echtzeit enthalten. In der folgenden Tabelle findest du die Methoden für jede Implementierung und Links zu den Protokollformaten:

Methode Definition Antwort HTTP-Anfrage
Seitenaufbau: BatchAvailabilityLookup

Wenn ein Nutzer für Ihren Händler auf Tisch reservieren klickt, wird die BatchAvailabilityLookup-Anfrage beim Laden der Seite aufgerufen.

Die Nutzlast enthält zahlreiche Slots, die auf Ihren letzten Feed-Uploads basieren und die von „Mit Google reservieren“ als verfügbar betrachtet werden.

 Die Antwort muss jede Slotanfrage und die aktuelle Verfügbarkeit des Slots enthalten. Dadurch werden keine nicht verfügbaren Zeiträume angezeigt. POST /v3/BatchAvailabilityLookup/
BatchAvailabilityLookup Klick auf den Bereich Wenn einem Nutzer verfügbare Slots für die Buchung angezeigt werden und er auf einen Slot klickt, wird die BatchAvailabilityLookup-Anfrage für den Slot-Klick aufgerufen. Die Antwort muss die aktuelle, tatsächliche Verfügbarkeit des Slots widerspiegeln. Wenn der Termin vor dem Klick auf den Slot ausgebucht ist, geben Sie die Antwort zurück, dass er nicht verfügbar ist. POST /v3/BatchAvailabilityLookup/
CreateBooking Wenn ein Nutzer bestätigt, dass er einen ausgewählten Zeitblock im Buchungsmodal buchen möchte, wird die CreateBooking-Anfrage gesendet.

Die Antwort muss den Erfolg oder Misserfolg der Buchung widerspiegeln.

Wenn die Buchung fehlgeschlagen ist, müssen Sie den genauen Grund für den Fehler zurückgeben. Der Slot war beispielsweise ausgebucht, bevor die CreateBooking-Antwort aufgerufen wurde.

Wenn eine erfolgreiche Buchung erstellt wird, enthält die Antwort eine eindeutige booking_id, mit der in zukünftigen Anfragen oder Aktualisierungen auf die Buchung verwiesen werden kann.

 POST /v3/CreateBooking/
UpdateBooking Nachdem ein Nutzer eine Buchung über „Mit Google reservieren“ vorgenommen hat, kann er sie ändern. Wenn der Nutzer seine Reservierung aktualisiert oder storniert, wird eine UpdateBooking-Anfrage gesendet. Wie bei der CreateBooking-Antwort muss Ihre Antwort auf UpdateBooking den Erfolg der Buchung darstellen oder den spezifischen Grund für einen Fehler zurückgeben. POST /v3/UpdateBooking/
HealthCheck Das Actions Center ruft Ihren Buchungsserver regelmäßig auf, um zu bestätigen, dass Ihre Infrastruktur aktiv ist.

Mit dem HTTP-Statuscode gibst du den Bereitstellungsstatus deines Servers an. Geben Sie den HTTP-Statuscode 200 zurück, wenn der Server aktiv ist und ordnungsgemäß ausgeführt wird.

Wenn Sie einen Fehler angeben oder Ihre Integration vorübergehend offline nehmen möchten, geben Sie den entsprechenden HTTP-Statuscode zurück, der nicht mit „2xx“ beginnt.

 GET /v3/HealthCheck/

Sandbox-Buchungsvorgang

Wenn Sie sich den Buchungsablauf in der Sandbox ansehen möchten, rufen Sie im Actions Center die Ansicht Inventar auf. In der Spalte RwG – E2E der Inventaransicht wird der Link Live (in Sandbox) zum Buchungsablauf in der Sandbox für Sandbox-Händler angezeigt, die abgestimmt sind und zukünftige Verfügbarkeit haben.

Die folgenden Aktionen sind im Buchungsablauf verfügbar:

  • Wenn Sie auf den Link RwG – E2E klicken, wird beim Laden der Seite eine BatchAvailabilityLookup-Anfrage ausgelöst und die bekannte Verfügbarkeit des Händlers angezeigt.
  • Wenn Sie auf eine Reservierungszeit klicken, wird die Anfrage BatchAvailabilityLookup ausgelöst und das Buchungsmodal wird angezeigt.
  • Schließen Sie eine Buchung mit dem Buchungsmodal ab, um die CreateBooking-Anfrage zu senden.
  • Nachdem Sie eine Buchung in der Sandbox-Umgebung abgeschlossen haben, erhält das Konto, mit dem die Buchung erstellt wurde, eine E‑Mail-Bestätigung mit den Buchungsdetails.
  • Wenn Sie die UpdateBooking-Methode auslösen möchten, ändern oder stornieren Sie die Buchung über die E-Mail.

HealthCheck

Implementieren Sie die Methode HealthCheck in der Sandbox- und der Produktionsumgebung. Diese Methode gibt den Status deines Buchungsservers zurück. Damit kann Google den Bereitstellungsstatus deines Buchungsservers kontinuierlich überwachen.

Anfrage: Keine

Rückgabewert: Keiner

Mit dem HTTP-Statuscode gibst du den Bereitstellungsstatus deines Servers an.

Wenn der Server aktiv ist und ordnungsgemäß läuft, muss ein 200er HTTP-Statuscode zurückgegeben werden, bei einem Fehler einer dieser Codes.