Buchungsserver bereit

Sie benötigen einen Buchungsserver, damit das Actions Center in Ihrem Namen Callbacks ausführen kann, um Buchungen zu erstellen und zu aktualisieren. So kann das Actions Center im Namen des Nutzers Termine, Buchungen und Reservierungen bei Ihnen erstellen.

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

Führen Sie die folgenden Aufgaben für den Buchungsserver aus, bevor Sie zu Echtzeit-Updates wechseln:

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

REST API-Schnittstelle implementieren

Implementieren Sie eine RESTAPI-Schnittstelle. So kann Google Buchungsserveranfragen über HTTPS senden.

Um eine API-Schnittstelle zu implementieren, richten Sie einen Entwicklungs- oder Sandbox-Buchungsserver ein, der mit der Sandbox-Umgebung des Actions Center 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 mit der Umgebungsumschaltung der richtige Buchungsserver-Endpunkt für die Sandbox- und die Produktionsumgebung konfiguriert ist.

Sicherheit und Authentifizierung

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

Alle Anfragen, die Google an Ihren Buchungsserver sendet, werden mit der HTTPS-Basisauthentifizierung authentifiziert. Sie können die Basis authentifizierungsinformationen, das Passwort und den Nutzernamen Ihres Buchungsservers auf der Konfigurationsseite des Buchungsservers im Actions Center eingeben. Die 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 Ihres Buchungsservers auf eine Anfrage von „Mit Google reservieren“ muss genaue Bestandsdetails in Echtzeit enthalten. In der folgenden Tabelle finden Sie die Methoden für jede Implementierung und Links zu den Formaten des Dienstprotokolls:

Methode Definition Antwort HTTP-Anfrage
BatchAvailabilityLookup-Seitenladefunktion

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 angesehen werden.

 Die Antwort muss jede Slot-Anfrage und die aktuelle Verfügbarkeit des Slots enthalten. So wird verhindert, dass nicht verfügbare Slots angezeigt werden. POST /v3/BatchAvailabilityLookup/
BatchAvailabilityLookup-Slot-Klickfunktion 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 darstellen. Wenn der Slot vor dem Klick darauf 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 Zeitraum im Buchungsmodal buchen möchte, wird die CreateBooking Anfrage gesendet.

Die Antwort muss den Erfolg oder Misserfolg der Buchung darstellen.

Wenn die Buchung fehlgeschlagen ist, müssen Sie den genauen Grund dafür angeben. Beispiel: Der Slot war ausgebucht, bevor die CreateBooking Antwort aufgerufen wurde.

Wenn eine erfolgreiche Buchung erstellt wurde, enthält die Antwort eine eindeutige booking_id mit der Sie in allen zukünftigen Anfragen oder Aktualisierungen auf die Buchung verweisen können.

 POST /v3/CreateBooking/
UpdateBooking Nachdem eine Buchung über „Mit Google reservieren“ vorgenommen wurde, kann ein Nutzer 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 genauen Grund für einen Fehler zurückgeben. POST /v3/UpdateBooking/
HealthCheck Das Actions Center ruft regelmäßig Ihren Buchungsserver auf, um zu bestätigen, dass Ihre Infrastruktur aktiv ist und ausgeführt wird.

Mit dem HTTP-Statuscode geben Sie den Bereitstellungsstatus Ihres 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 2 beginnt. HTTP-Statuscode.

 GET /v3/HealthCheck/

Meilensteinkriterien

Damit der Meilenstein „Buchungsserver bereit“ abgeschlossen werden kann, muss Ihre Integration die folgenden Kriterien in der Sandbox- und Produktionsumgebung erfüllen:

Methode Erforderliche Anzahl von Anfragen (Sandbox) Erforderliche Anzahl von Anfragen (Produktion) Erforderliche Erfolgsrate
BatchAvailabilityLookup -Seitenladefunktion 20 20 90%
BatchAvailabilityLookup -Slot-Klickfunktion 20 20 90%
CreateBooking 10 3 90%
UpdateBooking 10 3 90%

Sandbox-Buchungsablauf

Den Sandbox-Buchungsablauf finden Sie in der Bestandsansicht des Actions Center Inventory. In der Spalte Mit Google reservieren – E2E der Bestandsansicht wird der Link Live (in Sandbox) zum Sandbox-Buchungsablauf für Sandbox-Händler angezeigt, die übereinstimmen und zukünftige Verfügbarkeiten haben.

Folgende Aktionen sind im Buchungsablauf möglich:

  • Wenn Sie auf den Link Mit Google reservieren – 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 BatchAvailabilityLookup-Anfrage für den Slot-Klick ausgelöst und das Buchungsmodal 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 Bestätigungs-E-Mail 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 HealthCheck-Methode in der Sandbox- und Produktionsumgebung. Diese Methode gibt den Status Ihres Buchungsservers zurück. So kann Google den Bereitstellungsstatus Ihres Buchungsservers kontinuierlich überwachen.

Anfrage: Keine

Rückgabewert: Keine

Mit dem HTTP-Statuscode geben Sie den Bereitstellungsstatus Ihres Servers an.

Wenn der Server aktiv ist und ordnungsgemäß ausgeführt wird, geben Sie den HTTP-Statuscode 200 zurück. Wenn ein Fehler auftritt, geben Sie einen der HTTP-Statuscodes zurück.