In diesem Abschnitt findest du weitere Details zu den drei Hauptelementen einer Integration mit dem Actions Center. Die einzelnen Schritte werden im End-to-End-Leitfaden beschrieben.
Feeds
Feeds sind Dateien im JSON- oder pb3-Format, mit denen Ihre Inventardaten an das Actions Center gesendet werden. So kannst du all deine Daten gleichzeitig senden und Händler, Dienstleistungen und verfügbare Slots über einen SFTP-Upload aktualisieren.
Maps Booking API
Mit der Maps Booking API kannst du Objekte im Actions Center-System zwischen Feedeinreichungen aktualisieren. So bleiben die Informationen auf dem neuesten Stand. Über die API lassen sich auch Buchungen stornieren, die über die End-to-End-Integration von „Mit Google reservieren“ vorgenommen wurden.
Echtzeitaktualisierungen werden mit REST-Aufrufen implementiert.
Buchungsserver
Damit über die Ende-zu-Ende-Integration des Actions Centers Buchungen für Sie erstellt werden können, müssen Sie einen Buchungsserver einrichten.
REST API
Version 3 ist die neueste Version der API. Sie unterstützt eine REST-basierte Oberfläche. Alle neuen Integrationen sollten Version 3 der API verwenden.
In diesem Abschnitt werden die Feeddateien angegeben, mit denen Ihre Inventardaten an das Actions Center gesendet werden. In deinen Feeds gibst du an, welche Dienstleistungen du anbietest und welche direkt verfügbar sind bzw. wann sie verfügbar sind.
Im Akkordeon Referenzen und Beispiele erfahren Sie, wie Sie uns diese Feeds zur Verfügung stellen.
Die Struktur der Inventarfeeds wird durch die Google Maps Booking API definiert.
Der folgende Feed ist für jede Integration obligatorisch:
- Händlerfeed:Enthält Daten, mit denen Ihre Händler beschrieben werden.
Darüber hinaus sind die beiden folgenden Feeds für die End-to-End-Integration erforderlich.
- Dienstleistungsfeed:Hier werden die Dienstleistungen beschrieben, die deine Händler anbieten.
- Verfügbarkeitsfeed:Enthält die verfügbaren Slots (Zeitblöcke) für die Dienstleistungen deiner Händler.
Die Feeds enthalten Pflicht- und optionale Felder. Leere optionale Felder können im Feed ausgelassen werden.
Das Feedformat wird mithilfe der Protobuf-3-Syntax beschrieben. Du kannst die Feeddatei als binäre Serialisierung der Protobuf-Daten im PB3-Format oder in einem abgeleiteten JSON-Format hochladen. Wir empfehlen, die Feeds im JSON-Format hochzuladen.
Wir empfehlen, Feeds vor dem Upload mit gzip zu komprimieren.
Dieser Leitfaden bezieht sich speziell auf die Protokollpuffer des Actions Centers. In diesem Java-Beispiel findest du allgemeine Informationen dazu, wie du Protokollpuffer verwendest, um eine PB3-Datei zu generieren.