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
nameaufreservewithgoogle.action.v2fest. 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.
- 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" ] }