En esta sección, se proporcionan más detalles sobre los 3 componentes principales de una integración con el Centro de Acciones. Utilizarás cada uno de ellos en los pasos que se describen 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 mediante 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 diferentes envíos de feeds para mantener al día la información. 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 con llamadas REST.
Servidor de reservas
Para que la integración de extremo a extremo de Acciones 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 es compatible con una interfaz basada en REST. Todas las integraciones nuevas deben usar la API de la versión 3.
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.
Consulta el acordeón Referencias y muestras para obtener información sobre 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 siguientes 2 feeds son obligatorios para la integración de extremo a extremo.
- Feed de servicios: Describe los servicios que ofrecen tus comercios.
- Feed de disponibilidad: Indica 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. Puedes 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 que subas los feeds en formato JSON.
Te recomendamos usar gzip para comprimir los feeds antes de subirlos.
Esta guía es específica para los búferes de protocolo de Actions Center. 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.