En esta sección, se proporcionan más detalles sobre las 3 partes principales de una integración con el Centro de acciones. Usarás cada uno de ellos en los pasos descritos en la Guía de extremo a extremo.
Feeds
Los feeds son archivos en formato JSON o pb3 que se usan para transmitir los datos de tu inventario al Centro de acciones. Esto te permite
enviar todos tus datos a la vez para actualizar los comercios, servicios y
horarios disponibles con una carga de SFTP.
API de Maps Booking
La API de Maps Booking te permite actualizar objetos en el sistema de Actions Center entre los envíos de feeds para mantener la información actualizada. La API también te permite cancelar las reservas realizadas a través de la integración de extremo a extremo de Reserva con Google.
Las actualizaciones en tiempo real se implementan mediante llamadas de REST.
Servidor de reservas
Para que la integración de extremo a extremo de Actions Center cree reservas en tu nombre, debes configurar un servidor de reservas.
API de REST
La versión v3 es la más reciente de la API y admite una interfaz basada en REST. Todas las integraciones nuevas deben usar la API v3.
En esta sección, se especifican los archivos de feed que se usan para transmitir los datos de tu inventario al Centro de acciones. El contenido de tus feeds define qué servicios ofreces, qué servicios están disponibles y cuándo lo estarán.
Consulta el acordeón de Referencias y muestras para saber cómo compartir estos feeds con nosotros.
La API de Google Maps Booking define la estructura de los feeds de inventario.
El siguiente feed es obligatorio para cualquier integración:
- Feed de comercios: Contiene datos que describen tus comercios.
Además, los 2 feeds que se indican a continuación son obligatorios para la integración de extremo a extremo.
- Feed de servicios: Describe los servicios que ofrecen tus comercios.
- Feed de disponibilidad: Muestra una lista de los horarios disponibles de los servicios que ofrecen tus comercios.
Algunos campos de estos feeds son obligatorios y otros son opcionales. Los campos marcados como opcionales se pueden excluir del feed si están vacíos.
El formato de los feeds se describe mediante la sintaxis del búfer de protocolo 3. Tienes la opción de subir el archivo de feeds como una serialización binaria de los datos del búfer de protocolo en formato pb3 o en un formato JSON derivado. Te recomendamos subir los feeds en formato JSON.
Recomendamos usar gzip para comprimir los feeds antes de subirlos.
Esta guía es específica para los búferes de protocolo del Centro de acciones. Si deseas obtener información general sobre cómo usar los búferes de protocolo para generar un archivo pb3, consulta este ejemplo en Java.