Criar e fazer upload de feeds de ações
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 arquivo 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
namecomoreservewithgoogle.action.v2. Para ver um exemplo do arquivo descritor, consulte a amostra JSON. Recomendamos usar nomes de arquivo de descritor 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 de feeds para o servidor SFTP genérico diariamente como atualizações completas.
- Os detalhes do servidor SFTP estão na seção Configuração > Feeds do Portal de parceiros.
- Confira o status de ingestão do feed na seção Ingestão > Histórico do Portal de Parceiros.
Definições
Definição de ActionFeed
message ActionFeed { option features.(pb.java).nest_in_file_class = YES; repeated ActionDetail data = 1; }
Definição de ActionDetail
message ActionDetail { option features.(pb.java).nest_in_file_class = YES; string entity_id = 2; string link_id = 3; // Deep link for action detail string url = 4; // The actions that can be performed using this deep link. At least one // Action must be specified. repeated Action actions = 1; }
Definição da ação
// Information about an Action which could be performed. message Action { option features.(pb.java).nest_in_file_class = YES; // Deprecated fields not to be reused. reserved 1; oneof action_info { AppointmentInfo appointment_info = 2; } }
Definição de AppointmentInfo
// Indicates that the parent Action is for booking an appointment. // In v2 of the Action feed, the deep link URL is specified on ActionDetail.url, // so this message has no fields and should be set as an empty object // (for example, "appointment_info": {} in JSON). message AppointmentInfo { option features.(pb.java).nest_in_file_class = YES; }
Exemplos de feed de ações
Feed de ações
{ "data": [ { "entity_id": "appointments-merchant-1", "link_id": "appointment-link-1", "url": "https://www.partnerwebsite.com/appointment/appointment-partner-1", "actions":[ { "appointment_info": {} } ] } ] }
Arquivo descritor
{ "generation_timestamp": 1677540395, "name": "reservewithgoogle.action.v2", "data_file": [ "action_1677540395_0001.json", "action_1677540395_0002.json" ] }