Über Feeds werden Ihre Inventardaten an das Actions Center weitergegeben. Bei diesem täglichen SFTP-Upload (Secure File Transfer Protocol) werden alle Daten zu Händlern, Dienstleistungen und verfügbaren Slots aktualisiert. In Feeds wird angegeben, welche Händler Sie unterstützen, welche Verfügbarkeit sie haben und welche besonderen Funktionen erforderlich sind, damit Google Ihr Inventar richtig anzeigt. Feeds werden in die SFTP-Dropboxes hochgeladen, die konfiguriert werden, wenn Sie Ihren SSH-Schlüssel bei der Einrichtung angeben.
Sie müssen die folgenden Aufgaben unter „Feeds Ready“ erledigen, bevor Sie zum Buchungsserver wechseln:
Die Aufgaben werden als abgeschlossen markiert und grün angezeigt, nachdem Sie Ihre Feeds erfolgreich hochgeladen haben. Sehen Sie sich die verlinkte Dokumentation an, um die einzelnen Meilensteinaufgaben zu erledigen.
Damit die End-to-End-Integration für Restaurantreservierungen ordnungsgemäß funktioniert, müssen Sie täglich automatisch Händler-, Dienstleistungs- und Verfügbarkeitsfeeds hochladen. Ihre automatisierte Feedinfrastruktur muss Ihr gesamtes Inventar enthalten.
Feedtypen
Für End-to-End-Integrationen für Restaurantreservierungen sind die folgenden Feeds und Uploadhäufigkeiten erforderlich:
| Feed | Beschreibung | Häufigkeit | Beispiel |
|---|---|---|---|
| Händler | Beschreibt Ihre Händler. | Einmal alle 24 Stunden | Beispiel für einen Händlerfeed |
| Dienste | Beschreiben Sie die Dienstleistungen Ihrer Händler. | Einmal alle 24 Stunden | Beispiel für einen Dienstleistungsfeed |
| Verfügbarkeit | Beschreibt die verfügbaren Slots für die Dienstleistungen Ihrer Händler. Es muss eine Mindestdeckung von 30 Tagen bereitgestellt werden. Wenn Sie die Garantie auf 90 Tage verlängern möchten, wenden Sie sich über das Kontaktformular im Actions Center an den Google-Support. | Einmal alle 24 Stunden | Beispiel für Verfügbarkeitsfeed |
Feedformate werden mithilfe der Protobuf-3-Syntax beschrieben. Sie können Ihre Feeds jedoch im entsprechenden JSON-Format hochladen. Beispiele für Feeds im JSON-Format finden Sie in den Feedbeispielen. Wir empfehlen, die Feeds im JSON-Format hochzuladen.
Namenskonventionen und Metadaten
Dateinamen
Wenn Sie Sharding verwenden, müssen die hochgeladenen Feeds eindeutige Namen haben, in denen der Feedtyp und die Anzahl angegeben sind. Ein Zeitstempel für die Feederstellung erfüllt die Anforderung, dass die Benennung Ihrer Feeddatei eindeutig sein muss.
Struktur: {feed_name}_{timestamp_epoch}_{shard_nunber}_{total_shard}.json
Beispiel: availability_feed_1574117613_001_of_002.json.gz
IDs definieren
Wenn Sie IDs für Ihre Händler oder andere Attribute definieren, für die eine ID erforderlich ist, empfehlen wir dringend, UIDs oder UUIDs zu verwenden. Sie können Ihre eigene alphanumerische Lösung angeben, solange die IDs auf Ihrer Plattform eindeutig bleiben.
Metadaten
Wenn Sie Feeds erstellen, muss generation_timestamp den Zeitpunkt angeben, zu dem die Daten aus der Datenbank abgerufen wurden. Die Wiederverwendung dieses Werts in mehreren Feeds kann zu Verarbeitungsfehlern führen.
Nonce-Werte, zufällige oder nicht wiederholte Zahlen, müssen für alle Feedtypen eindeutig sein und dürfen nicht wiederverwendet werden. Der Wert muss für alle Dateien im jeweiligen Shard-Feed übereinstimmen.
Dateigröße des Feeds
Feeddateien fragmentieren
Je nach Inventar kann es erforderlich sein, Feeds in mehrere Dateien aufzuteilen. In den folgenden Fällen müssen Sie Ihre Feeds möglicherweise aufteilen:
- Der komprimierte GZIP-Feed überschreitet 200 MB für eine Datei.
- Beispiel: Der generierte Verfügbarkeitsfeed hat eine Größe von 1 GB. Die Daten müssen in mindestens fünf separate Shards aufgeteilt werden.
- Das Inventar von Partnern ist auf verschiedene Systeme oder Regionen verteilt, was die Abstimmung des Inventars erschwert.
- Beispiel: Ein Partner hat Inventar in den USA und der EU, das sich in separaten Systemen befindet.
Der Feed wird möglicherweise mit zwei Shards generiert. Einer für die USA und einer für die EU mit derselben Nonce und
generation_timestamp.
- Beispiel: Ein Partner hat Inventar in den USA und der EU, das sich in separaten Systemen befindet.
Der Feed wird möglicherweise mit zwei Shards generiert. Einer für die USA und einer für die EU mit derselben Nonce und
Weitere Informationen finden Sie unter Tutorials und Best Practices für das Sharding von Feeddateien.
Ein Feed kann aus mehreren Dateien bestehen, die als Shards bezeichnet werden. Beachte die folgenden Richtlinien, um die Größe der Feeds zu bestimmen:
- Vorgeschlagene Feed-Aufteilung:
- Händlerfeed: ein Shard.
- Dienstleistungsfeed: ein Shard.
- Verfügbarkeitsfeed: weniger als 20 Shards. Wenn Sie eine geschäftliche Begründung haben, die mehr als den angegebenen Betrag erfordert, wenden Sie sich an den Support, um weitere Informationen zu erhalten.
- Größe von Feeddateien und Sharding:
- Komprimierte Shard-Dateien dürfen maximal 200 MB groß sein. Verwende bei Bedarf mehrere Shards.
- Einzelne Datensätze, die in einem Shard gesendet werden, müssen in zukünftigen Feeds nicht im selben Shard gesendet werden.
- Für eine bessere Leistung sollten die Daten gleichmäßig auf die Shards aufgeteilt werden, sodass alle Shard-Dateien eine ähnliche Größe haben.
- Bei Bedarf kannst du gzip verwenden, um JSON-Feeds im Nur-Text-Format für jeden einzelnen Feed-Shard zu komprimieren.
Feeddateien komprimieren
Alle JSON- oder PB3-Dateien können vor dem Hochladen mit gzip komprimiert werden. Dadurch kann die Bytegröße von täglichen Feeds erheblich reduziert werden.
Jede Shard-Datei muss mit gzip komprimiert und einzeln hochgeladen werden, z. B. gzip*.json. Komprimierte Feed-Shards müssen auf .json.gz oder .pb3.gz enden.
Feeds in deine SFTP-Dropbox hochladen
Nachdem Sie die Feeds Händler, Dienstleistung und Verfügbarkeit generiert haben, können Sie sie über die SFTP-Dropbox in die Sandbox- oder Produktionsumgebung hochladen. Die SFTP-Dropbox wird konfiguriert, wenn Sie Ihren SSH-Schlüssel bei der Einrichtung angeben.
Der SFTP-Server von Google ist unter sftp://partnerupload.google.com auf Port 19321 verfügbar.
Google überprüft und validiert Feeddateien, sobald sie in die SFTP-Dropbox hochgeladen werden. Wenn der Feed in mehrere Dateien aufgeteilt ist, werden sie nach dem Hochladen der letzten Datei verarbeitet. Wenn Ihr Feed Fehler enthält, erhalten Sie eine E-Mail mit den Feed-Fehlercodes. Fehler verhindern, dass definierte Händler, Dienste oder Verfügbarkeiten aufgenommen werden. Nach der Validierung der Feeds kann es bis zu 24 Stunden dauern, bis sie im Frontend angezeigt werden.