Flux d'actions

Créer et importer des flux d'actions

Lorsque vous créez et importez des flux d'actions, suivez ces instructions :

  • Suivez les spécifications décrites dans le flux d'actions pour les fichiers de données d'action. Nous vous recommandons d'utiliser des noms de fichiers de données d'action uniques pour chaque importation. Incluez un code temporel dans le nom de fichier, par exemple action_1633621547.json.
  • Dans le descripteur d'ensemble de fichiers, définissez le name champ sur reservewithgoogle.action.v2. Pour obtenir un exemple de fichier descripteur, consultez l'exemple JSON. Nous vous recommandons d'utiliser des noms de fichiers descripteurs uniques pour chaque importation. Incluez un code temporel dans le nom de fichier, par exemple action_1633621547.filesetdesc.json. Le fichier descripteur doit être importé sur le serveur SFTP générique.
  • Importez les flux sur le serveur SFTP générique tous les jours en tant qu'actualisations complètes.
  • Vous trouverez les informations sur le serveur SFTP dans la section "Configuration" > "Flux" du portail des partenaires.

    • Sélection des serveurs de flux

    Sélectionner des serveurs de flux dans le portail des partenaires
  • Consultez l'état de l'ingestion des flux dans la section "Flux" > "Historique" du portail des partenaires.

Définitions

Définition d'ActionFeed

message ActionFeed {
  repeated ActionDetail data = 1;
}

Définition d'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;
}

Définition d'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;
  }
}

Définition d'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 {
}

Exemples de flux d'actions

Flux d'actions

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

Fichier descripteur

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

  ]
}