Feed Azioni

Creare e caricare feed di azioni

Quando crei e carichi feed di azioni, segui queste istruzioni:

• Segui le specifiche descritte nel feed delle azioni per i file di dati delle azioni. Ti consigliamo di utilizzare nomi di file di dati delle azioni univoci per ogni caricamento. Includi un timestamp nel nome file, ad esempio action_1633621547.json.
• Nel descrittore del set di file, imposta il campo name su reservewithgoogle.action.v2. Per un esempio del file descrittore, consulta l'esempio JSON. Ti consigliamo di utilizzare nomi di file descrittori univoci per ogni caricamento. Includi un timestamp nel nome file, ad esempio action_1633621547.filesetdesc.json. Il file descrittore deve essere caricato sul server SFTP generico.
• Carica i feed sul server SFTP generico ogni giorno come aggiornamenti completi.
• Puoi trovare i dettagli del server SFTP nella sezione Configurazione > Feed del Partner Portal.



Selezione dei server dei feed nel Partner Portal

• Visualizza lo stato di importazione dei feed nella sezione Feed > Cronologia del Partner Portal.

Definizioni

Nota:la specifica del feed di azioni definisce il formato protobuffer come segue, tuttavia ti consigliamo di caricare i feed in formato JSON. Per ulteriori informazioni, consulta Feed di esempio JSON.

Definizione di ActionFeed

message ActionFeed {
  repeated ActionDetail data = 1;
}

Definizione di ActionDetail

message ActionDetail {
  string entity_id = 2;
  string link_id = 3;

  // Deep link for action detail
  string url = 4;
  repeated Action actions = 1;
}

Definizione dell'azione

// 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;
  }
}

Definizione di FoodOrderingInfo

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

  ServiceType service_type = 1
      ;
}

Esempi di feed di Azione

Solo consegna

Nome file : 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"
    }
  ]
}

Solo asporto

Nome file : 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"
    }
  ]
}

Consegna a domicilio e asporto

Nome file : 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 diverso per consegna e asporto

Nome file : 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"
    }
  ]
}

File descrittore

Nome file : actions_1697754089.filesetdesc.json

{
  "generation_timestamp": 1697754089,
  "name": "reservewithgoogle.action.v2",
  "data_file": [
    "actions_1697754089_0001.json",
    "actions_1697754089_0002.json"
  ]
}