Aktionsfeed

Aktionsfeeds erstellen und hochladen

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

  • Folge der Spezifikation für Aktionsdatendateien, die im Aktionsfeed beschrieben wird. Wir empfehlen, für jeden Upload eindeutige Dateinamen für Aktionsdaten zu verwenden. Fügen Sie einen Zeitstempel in den Dateinamen ein, z. B. action_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. 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 generischen SFTP-Server hochgeladen werden.
  • Laden Sie Feeds täglich als vollständige Aktualisierungen auf den generischen SFTP-Server hoch.
  • Die Details zum SFTP-Server finden Sie im Partner-Portal im Bereich Konfiguration > Feeds.
  • Feedserver auswählen

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

  // The actions that can be performed using this deep link. At least one
  // Action must be specified.
  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 {
    AppointmentInfo appointment_info = 2;
  }
}

AppointmentInfo-Definition

// 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

Aktionsfeed

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

Deskriptordatei

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

  ]
}