Feed de ações

Criar e fazer upload de feeds de ações

Ao criar e fazer upload de feeds de ações, siga estas instruções:

  • Siga as especificações descritas nos feed de ações para arquivos de dados de ação. Use nomes de arquivos de dados de ações exclusivos entre os uploads. Recomendamos incluir um carimbo de data/hora no nome do arquivo, por exemplo, action1_1633621547.json.
  • No descritor do conjunto de arquivos, defina o campo name como reservewithgoogle.action.v2. Para ver um exemplo do arquivo descritor, consulte a Amostra JSON do arquivo descritor. Você precisa usar nomes de arquivos descritores únicos entre os uploads. Recomendamos incluir um carimbo de data/hora no nome do arquivo, por exemplo, action1_1633621547.filesetdesc.json. O arquivo descritor deve ser enviado para a caixa de depósito SFTP genérica.
  • Os feeds precisam ser enviados diariamente para a caixa de depósito SFTP genérica como completos é atualizado.
  • É possível encontrar informações sobre a caixa de depósito SFTP de feed genérico na Configuração > Seção "Feeds" do Portal do parceiro.
  • Seleção das caixas de depósito do feed

  • Você encontra o status de processamento do feed genérico na seção Feeds > Histórico do Portal do Parceiro.

Definições

Definição de ActionFeed

message ActionFeed {
  repeated ActionDetail data = 1;
}

Definição de ActionDetail

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

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

Definição da ação

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

Definição 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];
}

Exemplos de feed de ações

Somente entrega

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

Somente retirada

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

Entrega e retirada

Nome do arquivo : 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 diferente de entrega + retirada

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

Arquivo descritor

Nome do arquivo : actions1_1697754089.filesetdesc.json

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