Feed de acciones

Crea y sube feeds de acciones

Cuando crees y subas feeds de acciones, sigue estas instrucciones:

  • Sigue la especificación que se describe en el feed de acciones para los archivos de datos de acciones. Te recomendamos que uses nombres de archivos de datos de acción únicos para cada carga. Incluye una marca de tiempo en el nombre del archivo, por ejemplo, action_1633621547.json.
  • En el descriptor del conjunto de archivos, establece el campo name en reservewithgoogle.action.v2. Para ver un ejemplo del archivo de descriptor, consulta el ejemplo en JSON. Te recomendamos que uses nombres de archivo de descriptor únicos para cada carga. Incluye una marca de tiempo en el nombre del archivo, por ejemplo, action_1633621547.filesetdesc.json. El archivo descriptor se debe subir al servidor SFTP genérico.
  • Sube feeds al servidor SFTP genérico todos los días como actualizaciones completas.
  • Puedes encontrar los detalles del servidor SFTP en la sección Configuración > Feeds del Partner Portal.
  • Selecciona servidores de feeds

    Cómo seleccionar servidores de feeds en el Partner Portal
  • Consulta el estado de la transferencia del feed en la sección Feeds > History del Partner Portal.

Definiciones

Definición de ActionFeed

message ActionFeed {
  repeated ActionDetail data = 1;
}

Definición de ActionDetail

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

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

Definición de la acción

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

Definición de FoodOrderingInfo

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

  ServiceType service_type = 1
      ;
}

Muestras del feed de acciones

Solo ofrece servicio de entrega

Nombre de archivo : 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 ofrece servicio de comida para llevar

Nombre de archivo : 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"
    }
  ]
}

Servicios de entrega y comida para llevar

Nombre de archivo : 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"
    }
  ]
}

La URL de Delivery+takeout es diferente

Nombre de archivo : 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"
    }
  ]
}

Archivo de descriptor

Nombre de archivo : actions_1697754089.filesetdesc.json

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