Aktionsfeed

Aktionsfeeds erstellen und hochladen

Beachten Sie beim Erstellen und Hochladen von Aktionsfeeds die folgenden Hinweise:

  • Halten Sie sich an die Spezifikation, die im Aktionsfeed für Aktionsdatendateien beschrieben ist. Wir empfehlen, für jeden Upload eindeutige Dateinamen für Aktionsdaten zu verwenden. Fügen Sie dem Dateinamen einen Zeitstempel hinzu, z. B. action_1633621547.json.
  • Legen Sie im Fileset-Deskriptor das Feld name auf reservewithgoogle.action.v2 fest. Ein Beispiel für die Deskriptordatei finden Sie im JSON-Beispiel. Wir empfehlen, für jeden Upload eindeutige Namen für die Deskriptordateien zu verwenden. Fügen Sie dem Dateinamen einen Zeitstempel hinzu, z. B. action_1633621547.filesetdesc.json. Die Deskriptordatei muss auf den allgemeinen SFTP-Server hochgeladen werden.
  • Laden Sie Feeds täglich als vollständige Aktualisierungen auf den allgemeinen SFTP-Server hoch.
  • Details zum SFTP-Server findest du im Partner-Portal unter Konfiguration > Feeds.

    • Feedserver auswählen

    Feedserver im Partner-Portal auswählen
  • Den Status der Feedaufnahme finden 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
      ;
}

Beispiele für den Aktionsfeed

Nur Lieferservice

Dateiname : actions_1697754089_0001.json

{
  "data": [
    {
      "actions": [{ "food_ordering_info": { "service_type": "DELIVERY" } }],
      "entity_id": "dining-1",
      "link_id": "delivery-dining-1",
      "url": "https://www.restaurant.com/delivery/dining-1"
    }
  ]
}

Nur zum Mitnehmen

Dateiname : actions_1697754089_0001.json

{
  "data": [
    {
      "actions": [{ "food_ordering_info": { "service_type": "TAKEOUT" } }],
      "entity_id": "dining-1",
      "link_id": "takeout-link-dining-1",
      "url": "https://www.restaurant.com/takeout/dining-1"
    }
  ]
}

Lieferung und Mitnahme

Dateiname : actions_1697754089_0001.json

{
  "data": [
    {
      "actions": [
        { "food_ordering_info": { "service_type": "DELIVERY" } },
        { "food_ordering_info": { "service_type": "TAKEOUT" } }
      ],
      "entity_id": "dining-1",
      "link_id": "common-link-dining-1",
      "url": "https://www.restaurant.com/commonlink/dining-1"
    }
  ]
}

Lieferung und Mitnahme haben unterschiedliche URLs

Dateiname : actions_1697754089_0001.json

{
  "data": [
    {
      "actions": [
        {
          "food_ordering_info": {
            "service_type": "TAKEOUT"
          }
        }
      ],
      "entity_id": "dining-1",
      "link_id": "takeout-dining-1",
      "url": "https://www.restaurant.com/takeout/dining-1"
    },
    {
      "actions": [
        {
          "food_ordering_info": {
            "service_type": "DELIVERY"
          }
        }
      ],
      "entity_id": "dining-1",
      "link_id": "delivery-dining-1",
      "url": "https://www.restaurant.com/delivery/dining-1"
    }
  ]
}

Deskriptordatei

Dateiname : actions_1697754089.filesetdesc.json

{
  "generation_timestamp": 1697754089,
  "name": "reservewithgoogle.action.v2",
  "data_file": [
    "actions_1697754089_0001.json",
    "actions_1697754089_0002.json"
  ]
}
Zurück
Entitätsfeed
Weiter
Service feed