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 du fichier, par exemple action_1633621547.json.
• Dans le descripteur d'ensemble de fichiers, définissez le champ name sur reservewithgoogle.action.v2. Pour obtenir un exemple de fichier descripteur, consultez l'exemple JSON. Nous vous recommandons d'utiliser des noms de fichiers de descripteurs uniques pour chaque importation. Incluez un code temporel dans le nom du fichier, par exemple action_1633621547.filesetdesc.json. Le fichier descripteur doit être importé sur le serveur SFTP générique.
• Importez quotidiennement les flux sur le serveur SFTP générique en tant qu'actualisations complètes.
• Vous trouverez les détails du serveur SFTP dans la section Configuration > Flux du Partner Portal.



• Consultez l'état d'ingestion du flux dans la section Ingestion > Historique du Partner Portal.

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 de l'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

{
  "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"

  ]
}