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 du fichier, 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 description 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 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électionner 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;
  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 {
    FoodOrderingInfo food_ordering_info = 3;
  }
}

Définition de FoodOrderingInfo

message FoodOrderingInfo {
  // Service type for food ordering action.
  enum ServiceType {
    UNKNOWN = 0;
    DELIVERY = 1;
    TAKEOUT = 2;
  }

  ServiceType service_type = 1
      ;
}

Exemples de flux d'actions

Livraison uniquement

Nom de fichier : actions_1697754089_0001.json

{
  "data": [
    {
      "actions": [{ "food_ordering_info": { "service_type": "DELIVERY" } }],
      "entity_id": "dining-1",
      "link_id": "delivery-dining-1",
      "url": "https://www.restaurant.com/delivery/dining-1"
    }
  ]
}

Vente à emporter uniquement

Nom de fichier : actions_1697754089_0001.json

{
  "data": [
    {
      "actions": [{ "food_ordering_info": { "service_type": "TAKEOUT" } }],
      "entity_id": "dining-1",
      "link_id": "takeout-link-dining-1",
      "url": "https://www.restaurant.com/takeout/dining-1"
    }
  ]
}

Livraison et vente à emporter

Nom de fichier : actions_1697754089_0001.json

{
  "data": [
    {
      "actions": [
        { "food_ordering_info": { "service_type": "DELIVERY" } },
        { "food_ordering_info": { "service_type": "TAKEOUT" } }
      ],
      "entity_id": "dining-1",
      "link_id": "common-link-dining-1",
      "url": "https://www.restaurant.com/commonlink/dining-1"
    }
  ]
}

URL différente pour la livraison et la vente à emporter

Nom de fichier : actions_1697754089_0001.json

{
  "data": [
    {
      "actions": [
        {
          "food_ordering_info": {
            "service_type": "TAKEOUT"
          }
        }
      ],
      "entity_id": "dining-1",
      "link_id": "takeout-dining-1",
      "url": "https://www.restaurant.com/takeout/dining-1"
    },
    {
      "actions": [
        {
          "food_ordering_info": {
            "service_type": "DELIVERY"
          }
        }
      ],
      "entity_id": "dining-1",
      "link_id": "delivery-dining-1",
      "url": "https://www.restaurant.com/delivery/dining-1"
    }
  ]
}

Fichier de descripteur

Nom de fichier : actions_1697754089.filesetdesc.json

{
  "generation_timestamp": 1697754089,
  "name": "reservewithgoogle.action.v2",
  "data_file": [
    "actions_1697754089_0001.json",
    "actions_1697754089_0002.json"
  ]
}
Précédent
Flux d'entités
Suivant
Flux du service