Aktionsfeeds erstellen und hochladen
Beachten Sie beim Erstellen und Hochladen von Aktionsfeeds die folgende Anleitung:
- Halte dich für Dateien mit Aktionsdaten an die im Aktionsfeed beschriebenen Spezifikationen. Zwischen Uploads müssen eindeutige Dateinamen für Aktionsdaten verwendet werden.
Es wird empfohlen, einen Zeitstempel in den Dateinamen aufzunehmen, z. B.
action1_1633621547.json
. - Legen Sie im Dateisatzdeskriptor das Feld
name
aufreservewithgoogle.action.v2
fest. Ein Beispiel für die Deskriptordatei finden Sie im JSON-Beispiel für die Deskriptordatei. Zwischen Uploads müssen eindeutige Deskriptor-Dateinamen verwendet werden. Es wird empfohlen, einen Zeitstempel in den Dateinamen aufzunehmen, z. B.action1_1633621547.filesetdesc.json
. Die Deskriptordatei muss in die generische SFTP-Dropbox hochgeladen werden. - Feeds müssen täglich vollständig aktualisiert in die generische SFTP-Dropbox hochgeladen werden.
- Allgemeine SFTP-Dropbox-Informationen für Feeds findest du im Abschnitt Konfiguration > Feeds des Partner-Portals.
- Den Status der allgemeinen Feedaufnahme sehen Sie im Partner-Portal unter Feeds > Verlauf.
Definitionen
ActionFeed – Definition
message ActionFeed { repeated ActionDetail data = 1; }
ActionDetail – Definition
message ActionDetail { string entity_id = 2; string link_id = 3; // Deep link for action detail string url = 4; repeated Action actions = 1; }
Aktionsdefinition
// Information about an Action which could be performed. message Action { // Deprecated fields not to be reused. reserved 1; oneof action_info { FoodOrderingInfo food_ordering_info = 3; } }
FoodOrderingInfo – Definition
message FoodOrderingInfo { // Service type for food ordering action. enum ServiceType { UNKNOWN = 0; DELIVERY = 1; TAKEOUT = 2; } ServiceType service_type = 1 [features.field_presence = IMPLICIT]; }
Beispiele für Aktionsfeeds
Nur Lieferservice
Dateiname : actions1_1697754089.json
{ "data": [ { "actions": [{ "food_ordering_info": { "service_type": "DELIVERY" } }], "entity_id": "entity002", "link_id": "delivery_link/entity002", "url": "https://www.restaurant.com/delivery/entity002" } ] }
Nur zum Mitnehmen
Dateiname : actions1_1697754089.json
{ "data": [ { "actions": [{ "food_ordering_info": { "service_type": "TAKEOUT" } }], "entity_id": "entity002", "link_id": "takeout_link/entity002", "url": "https://www.restaurant.com/takeout/entity002" } ] }
Lieferung und Essen zum Mitnehmen
Dateiname : actions1_1697754089.json
{ "data": [ { "actions": [ { "food_ordering_info": { "service_type": "DELIVERY" } }, { "food_ordering_info": { "service_type": "TAKEOUT" } } ], "entity_id": "entity002", "link_id": "common_link/entity002", "url": "https://www.restaurant.com/commonlink/entity002" } ] }
Unterschiedliche URL für Lieferung und Abholung
Dateiname : actions1_1697754089.json
{ "data": [ { "actions": [ { "food_ordering_info": { "service_type": "TAKEOUT" } } ], "entity_id": "entity002", "link_id": "takeout_link/entity002", "url": "https://www.restaurant.com/takeout/entity002" }, { "actions": [ { "food_ordering_info": { "service_type": "DELIVERY" } } ], "entity_id": "entity002", "link_id": "delivery_link/entity002", "url": "https://www.restaurant.com/delivery/entity002" } ] }
Deskriptordatei
Dateiname : actions1_1697754089.filesetdesc.json
{ "generation_timestamp": 1697754089, "name": "reservewithgoogle.action.v2", "data_file": ["actions1_1697754089.json"] }