Feed de acción

Crea y sube feeds de acciones

Cuando crees y subas feeds de acciones, asegúrate de seguir estas instrucciones:

• Sigue las especificaciones que se describen en el feed de acciones para los archivos de datos de acciones. Debes usar nombres de archivo de datos de acciones únicos entre las cargas. Se recomienda incluir una marca de tiempo en el nombre del archivo, por ejemplo, action1_1633621547.json.
• En el descriptor de conjunto de archivos, establece el campo name en reservewithgoogle.action.v2. Para obtener un ejemplo del archivo descriptor, consulta el Ejemplo de JSON del archivo descriptor. Debes usar nombres de archivo descriptores únicos entre las cargas. Se recomienda incluir una marca de tiempo en el nombre del archivo, por ejemplo, action1_1633621547.filesetdesc.json. El archivo descriptor se debe subir al buzón de SFTP genérico.
• Los feeds se deben subir al buzón de SFTP genérico a diario como actualizaciones completas.
• Puedes encontrar información genérica del buzón de SFTP del feed en la sección Configuración > Feeds del Portal para socios.



• Puedes encontrar el estado de transferencia del feed genérico en la sección Feeds > Historial del Portal para socios.

Definiciones

Nota: La especificación del feed de acciones se define en formato protobuffer de la siguiente manera. Sin embargo, te recomendamos subir los feeds en formato JSON. Para obtener más información, consulta la página de feeds de muestra de JSON.

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

Muestras del feed de acción

Solo ofrece servicio de entrega

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

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

Servicios de entrega y comida para llevar

Nombre del archivo : 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 de entrega y comida para llevar diferente

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

Archivo descriptor

Nombre del archivo : actions1_1697754089.filesetdesc.json

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