Feed de ações

Criar e fazer upload de feeds de ação

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

• Siga a especificação descrita no feed de ações para arquivos de dados de ações. Recomendamos usar nomes de arquivos de dados de ação exclusivos para cada upload. Inclua um carimbo de data/hora no nome do arquivo, por exemplo, action_1633621547.json.
• No descritor do conjunto de arquivos, defina o campo name como reservewithgoogle.action.v2. Para um exemplo do arquivo de descritor, consulte o exemplo JSON. Recomendamos usar nomes de arquivos descritores exclusivos para cada upload. Inclua um carimbo de data/hora no nome do arquivo, por exemplo, action_1633621547.filesetdesc.json. O arquivo descritor precisa ser enviado para o servidor SFTP genérico.
• Faça upload dos feeds para o servidor SFTP genérico diariamente como atualizações completas.
• Você pode encontrar os detalhes do servidor SFTP na seção Configuração > Feeds do portal de parceiros.



Selecionar servidores de feed no Portal de parceiros

• Confira o status da ingestão de feeds na seção Feeds > Histórico do Portal de parceiros.

Definições

Observação:a especificação do feed de ações é definida no formato protobuffer da seguinte maneira, mas recomendamos que você faça upload dos feeds no formato JSON. Para mais informações, consulte Exemplos de feeds JSON.

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

Exemplos de feed de ações

Somente entrega

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

Somente retirada

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

Entrega e retirada

Nome do arquivo : 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 diferente para entrega e retirada

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

Arquivo descritor

Nome do arquivo : actions_1697754089.filesetdesc.json

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