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. Du verwendest sie, um deine Inventardaten an das Actions Center zu senden. 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.
Booking Server (Buchungsserver)
Damit in der End-to-End-Integration des Actions Center Buchungen für dich erstellt werden können, musst du 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 deine 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 erfährst du, wie du diese Feeds für uns freigeben kannst.
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 deine Händler beschrieben werden.
Außerdem sind die folgenden beiden Feeds für die End-to-End-Integration obligatorisch.
- Dienstleistungsfeed: Beschreibt die Dienstleistungen, 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 hast die Option, die Feeddatei als binäre Serialisierung der Protokoll Pufferdaten 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 Protokollpuffer des Actions Center. In diesem Java-Beispiel findest du allgemeine Informationen dazu, wie du Protokollpuffer verwendest, um eine PB3 Datei zu generieren, hier ist ein Beispiel in Java.