Nesta seção, fornecemos mais detalhes sobre os três principais fragmentos de uma integração com o Centro de ações. Você vai usar cada um deles nas etapas descritas no guia completo.
Feeds
Os feeds
são arquivos no formato JSON ou
pb3 usados para
transmitir os dados de inventário ao Centro de ações. Com isso, você pode enviar 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. A API 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 é a mais recente da API e oferece suporte a 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 ao Centro de ações. O conteúdo dos feeds define quais serviços você está fornecendo, quais estão disponíveis e quando eles estão disponíveis.
Consulte o acordeão Referências e amostras para saber como compartilhar esses feeds com a gente.
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 seus 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 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 o uso de gzip para compactar feeds antes do upload.
Este guia é específico para buffers de protocolo do Centro de ações. Para informações gerais sobre como usar os buffers de protocolo para gerar um arquivo pb3, confira um exemplo em Java.