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
comoreservewithgoogle.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.
- 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"] }