In diesem Abschnitt werden die drei Hauptbestandteile einer Integration mit dem Actions Center genauer beschrieben. Die einzelnen Schritte werden im End-to-End-Leitfaden beschrieben.
Feeds
Feeds sind Dateien im Format JSON oder pb3, mit denen Ihre Inventardaten an das Actions Center gesendet werden. So kannst du alle deine Daten auf einmal einreichen, um Händler, Dienstleistungen und verfügbare Slots per SFTP-Upload zu aktualisieren.
Maps Booking API
Mit der Maps Booking API kannst du Objekte im Actions Center-System zwischen Feedeinreichungen aktualisieren, um Informationen auf dem neuesten Stand zu halten. Mit der API kannst du auch Buchungen stornieren, die über die End-to-End-Integration von "Mit Google reservieren" vorgenommen wurden.
Echtzeitaktualisierungen werden mithilfe von REST-Aufrufen implementiert.
Buchungsserver
Damit die End-to-End-Integration des Actions Centers Buchungen in deinem Namen erstellen kann, musst du einen Buchungsserver einrichten.
REST API
Die Version 3 ist die neueste Version der API und unterstützt eine REST-basierte Schnittstelle. Für alle neuen Integrationen sollte Version 3 der API verwendet werden.
In diesem Abschnitt werden die Feeddateien angegeben, mit denen Ihre Inventardaten an das Actions Center gesendet werden. Aus den Inhalten deiner Feeds ist festgelegt, welche Dienstleistungen du anbietest, welche verfügbar sind und wann sie verfügbar sind.
Im Artikel Referenzen und Beispiele erfährst du, wie du diese Feeds mit uns teilen kannst.
Die Struktur der Inventarfeeds wird von der Google Maps Booking API definiert.
Der folgende Feed ist für jede Integration obligatorisch:
- Händlerfeed:Dieser Feed enthält Daten, mit denen deine Händler beschrieben werden.
Außerdem sind die beiden folgenden Feeds für die End-to-End-Integration obligatorisch.
- Dienstleistungsfeed:Beschreibt die Dienstleistungen, die deine Händler anbieten.
- Verfügbarkeitsfeed:Hier werden die verfügbaren Slots der Dienstleistungen deiner Händler aufgelistet.
Die Feeds enthalten Pflicht- und optionale Felder. Jedes als optional gekennzeichnete Feld kann aus dem Feed ausgeschlossen werden, wenn es leer ist.
Das Feedformat wird mithilfe der Protobuf-3-Syntax beschrieben. Du hast die Möglichkeit, die Feeddatei als binäre Serialisierung der Protokollpufferdaten im pb3-Format oder in einem abgeleiteten JSON-Format hochzuladen. Wir empfehlen, die Feeds im JSON-Format hochzuladen.
Wir empfehlen, Feeds vor dem Hochladen mit gzip zu komprimieren.
Dieser Leitfaden bezieht sich speziell auf die Protokollzwischenspeicher des Actions Center. Allgemeine Informationen zur Verwendung der Protokollpuffer zum Generieren einer PB3-Datei findest du in diesem Java-Beispiel.