Aktionsfeed

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 auf reservewithgoogle.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.
  • Feed-Dropboxes auswählen

  • 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"]
}