Flux d'actions

Créer et importer des flux d'actions

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

  • Respectez les spécifications décrites dans le flux d'action pour les fichiers de données d'action. Vous devez utiliser des noms de fichier de données d'action uniques entre les importations. Nous vous recommandons d'inclure un code temporel dans le nom du fichier, par exemple action1_1633621547.json.
  • Dans le descripteur de l'ensemble de fichiers, définissez le champ name sur reservewithgoogle.action.v2 Pour obtenir un exemple de fichier descripteur, consultez l'exemple JSON de fichier descripteur. Vous devez utiliser des noms de fichiers de descripteurs uniques entre les importations. Nous vous recommandons d'inclure un code temporel dans le nom du fichier, par exemple action1_1633621547.filesetdesc.json. Le fichier descripteur doit être importé dans la boîte de dépôt SFTP générique.
  • Les flux doivent être importés quotidiennement dans la boîte de dépôt SFTP générique avec un état complet s'actualise.
  • Vous trouverez des informations sur la boîte de dépôt SFTP générique dans le Configuration > "Flux" du portail des partenaires.

    • Sélectionner des boîtes de dépôt de flux

  • Vous trouverez l'état générique de l'ingestion du flux dans la section Flux > Historique du portail des partenaires.

Définitions

<ph type="x-smartling-placeholder">

ActionFeed – Définition

message ActionFeed {
  repeated ActionDetail data = 1;
}

Définition ActionDetails

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 [features.field_presence = IMPLICIT];
}

Exemples de flux d'actions

Livraison uniquement

Nom du fichier : actions1_1697754089.json

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

Vente à emporter uniquement

Nom du fichier : actions1_1697754089.json

{
  "data": [
    {
      "actions": [{ "food_ordering_info": { "service_type": "TAKEOUT" } }],
      "entity_id": "entity002",
      "link_id": "takeout_link/entity002",
      "url": "https://www.restaurant.com/takeout/entity002"
    }
  ]
}

Livraison et vente à emporter

Nom du fichier : actions1_1697754089.json

{
  "data": [
    {
      "actions": [
        { "food_ordering_info": { "service_type": "DELIVERY" } },
        { "food_ordering_info": { "service_type": "TAKEOUT" } }
      ],
      "entity_id": "entity002",
      "link_id": "common_link/entity002",
      "url": "https://www.restaurant.com/commonlink/entity002"
    }
  ]
}

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

Nom du fichier : actions1_1697754089.json

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

Fichier de descripteur

Nom du fichier : actions1_1697754089.filesetdesc.json

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