Aktionsfeed

Aktionsfeeds erstellen und hochladen

Folgen Sie dieser Anleitung, wenn Sie Aktionsfeeds erstellen und hochladen:

• Halten Sie sich an die Spezifikation, die im Aktionsfeed für Aktionsdatendateien beschrieben ist. Wir empfehlen, für jeden Upload eindeutige Namen für Aktionsdatendateien zu verwenden. Fügen Sie dem Dateinamen einen Zeitstempel hinzu, z. B. action_1633621547.json.
• Legen Sie im Dateisatzdeskriptor das name Feld 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 Deskriptordateien zu verwenden. Fügen Sie dem Dateinamen einen Zeitstempel hinzu, z. B. action_1633621547.filesetdesc.json. Die Deskriptordatei muss auf den generischen SFTP-Server hochgeladen werden.
• Laden Sie Feeds täglich als vollständige Aktualisierungen auf den generischen SFTP-Server hoch.
• Details zum SFTP-Server finden Sie im Partner-Portal unter „Konfiguration“ > „Feeds“.



• Den Status der Feedaufnahme finden Sie im Partner-Portal unter „Feeds“ > „Verlauf“.

Definitionen

Definition von „ActionFeed“

message ActionFeed {
  repeated ActionDetail data = 1;
}

Definition von „ActionDetail“

message ActionDetail {
  string entity_id = 2;
  string link_id = 3;

  // Deep link for action detail
  string url = 4;

  // The actions that can be performed using this deep link. At least one
  // Action must be specified.
  repeated Action actions = 1;
}

Definition von „Action“

// Information about an Action which could be performed.
message Action {
  // Deprecated fields not to be reused.
  reserved 1;

  oneof action_info {
    AppointmentInfo appointment_info = 2;
  }
}

Definition von „AppointmentInfo“

// Indicates that the parent Action is for booking an appointment.
// In v2 of the Action feed, the deep link URL is specified on ActionDetail.url,
// so this message has no fields and should be set as an empty object
// (for example, "appointment_info": {} in JSON).
message AppointmentInfo {
}

Beispiele für Aktionsfeeds

{
  "data": [
    {
      "entity_id": "appointments-merchant-1",
      "link_id": "appointment-link-1",
      "url": "https://www.partnerwebsite.com/appointment/appointment-partner-1",
      "actions":[
        {
          "appointment_info": {}
        }
      ]
    }
  ]
}

{
  "generation_timestamp": 1677540395,
  "name": "reservewithgoogle.action.v2",
  "data_file": [
    "action_1677540395_0001.json",
    "action_1677540395_0002.json"

  ]
}