Esta seção oferece mais detalhes sobre os três principais elementos de uma integração com a Central de ações. Você vai usar cada um deles nas etapas descritas no guia completo.
Feeds
Feeds
são arquivos no formato JSON ou
pb3 usados para
enviar seus dados de inventário à Central de ações. Com isso, você pode transmitir todos os seus dados de uma vez para atualizar os comerciantes, serviços e
horários disponíveis usando um upload de SFTP.
API Maps Booking
Com a API Maps Booking, você pode atualizar objetos no sistema da Central de ações entre envios de feeds para manter as informações atualizadas. Ela também permite cancelar as reservas feitas usando a integração completa do Reservar com o Google.
As atualizações em tempo real são implementadas usando chamadas REST.
Servidor de agendamento
Para que a integração completa da Central de ações crie reservas em seu nome, você precisa configurar um servidor de reserva.
API REST
A versão v3 da API é a mais recente e é compatível com uma interface com base em REST. Todas as novas integrações precisam usar a API v3.
Esta seção especifica os arquivos de feed usados para transmitir seus dados de inventário à Central de ações. O conteúdo dos feeds determina quais serviços você fornece, quais estão disponíveis e quando os serviços estão disponíveis.
Confira o acordeão Referências e exemplos para saber como compartilhar esses feeds conosco.
A estrutura dos feeds de inventário é definida pela API Google Maps Booking.
O feed a seguir é obrigatório em qualquer integração:
- Feed de comerciantes: contém dados que descrevem os comerciantes.
Além disso, os dois feeds a seguir são obrigatórios para a integração completa.
- Feed de serviços: descreve os serviços fornecidos pelos seus comerciantes.
- **Feed de disponibilidade**: informa os espaços disponíveis para os serviços oferecidos pelos comerciantes.
Alguns campos desses feeds são obrigatórios, e outros são opcionais. Qualquer campo marcado como opcional poderá ser removido do feed se estiver vazio.
O formato dos feeds é descrito usando a sintaxe do buffer de protocolo 3. É possível fazer o upload do arquivo de feeds como uma serialização binária dos dados do buffer de protocolo no formato pb3 ou em um formato JSON derivado. Recomendamos fazer o upload dos feeds no formato JSON.
Recomendamos usar o gzip para compactar os feeds antes do upload.
Este guia é específico para buffers de protocolo da Central de ações. Se quiser informações gerais sobre como usar os buffers de protocolo para gerar um arquivo pb3 file, veja um exemplo em Java.