Esta seção dá mais detalhes sobre as três partes principais de uma integração com a Central de ações. Você usará cada um deles nas etapas descritas no guia completo.
Feeds
Feeds são arquivos no formato JSON ou pb3 usados para transmitir seus dados de inventário para a Central de ações. Isso permite que você envie todos os seus dados de uma só vez para atualizar os comerciantes, serviços e espaços de disponibilidade usando um upload SFTP.
API Maps Booking
Com a API Maps Booking, você atualiza objetos no sistema da Central de ações entre os envios de feed para manter as informações atualizadas. Com ela, também é possível cancelar agendamentos feitos pela 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 do Actions Center crie reservas em seu nome, é necessário configurar um servidor de agendamento.
API REST
A versão v3 é a mais recente da API e é compatível com uma interface baseada em REST. Todas as novas integrações devem usar a API v3.
Esta seção especifica os arquivos de feed usados para transmitir seus dados de inventário para a Central de ações. O conteúdo dos feeds define quais serviços você oferece, quais estão disponíveis e quando eles podem ser disponibilizados.
Acesse o menu suspenso Referências e amostras para saber como compartilhar esses feeds.
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: lista os horários dos serviços fornecidos pelos seus comerciantes.
Alguns campos desses feeds são obrigatórios, e outros são opcionais. Qualquer campo marcado como opcional pode ser deixado de fora do feed quando está vazio.
O formato dos feeds é descrito usando a sintaxe do buffer de protocolo 3. É possível fazer 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 upload dos feeds no formato JSON.
Recomendamos o uso do gzip para compactar os feeds antes do upload.
Este guia é específico para os buffers de protocolo da Central de ações. Para informações gerais sobre como usar os buffers de protocolo para gerar um arquivo pb3, veja um exemplo em Java.