Feed azioni

Creare e caricare feed delle azioni

Quando crei e carichi feed delle azioni, assicurati di seguire queste istruzioni:

  • Segui le specifiche descritte in feed di azioni per i file di dati sulle azioni. Devi utilizzare nomi di file di dati delle azioni univoci tra i caricamenti. È consigliabile includere un timestamp nel nome del file, ad esempio action1_1633621547.json.
  • Nel descrittore del set di file, imposta il campo name su reservewithgoogle.action.v2. Per un esempio del file del descrittore, consulta Esempio di file JSON del file descrittore. Devi utilizzare nomi di file descrittori univoci tra i caricamenti. È consigliabile includere un timestamp nel nome del file, ad esempio action1_1633621547.filesetdesc.json. Il file descrittore deve essere caricato nella casella personale SFTP generica.
  • I feed devono essere caricati quotidianamente nella casella personale SFTP generica come completi vengono aggiornate.
  • Puoi trovare informazioni generiche sulla casella personale SFTP del feed nel Configurazione > Feed del Portale partner.

    • Selezione delle caselle personali dei feed

  • Puoi trovare lo stato di importazione del feed generico nella Feed > Cronologia del Portale partner.

Definizioni

Definizione di ActionFeed

message ActionFeed {
  repeated ActionDetail data = 1;
}

Definizione di ActionDetails

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

Esempi di feed di azioni

Solo consegna

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

Solo asporto

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

Consegna a domicilio e asporto

Filename : 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 diverso per consegna+ritiro

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

File descrittore

Filename : actions1_1697754089.filesetdesc.json

{
  "generation_timestamp": 1697754089,
  "name": "reservewithgoogle.action.v2",
  "data_file": ["actions1_1697754089.json"]
}
Indietro
Feed entità
Avanti
Feed di servizio