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 descritos en la Guía de extremo a extremo.
Feeds
Los feeds
son archivos en formato JSON o
pb3 que se utilizan 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 del Centro de acciones 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 mediante llamadas REST.
Servidor de reservas
Para que la integración de extremo a extremo del Centro de acciones 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 utilizar la versión v3 de la API.
En esta sección, se especifican los archivos de feed que se utilizan 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 están disponibles los servicios.
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 en 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. Cualquier campo marcado como opcional se puede omitir del feed cuando esté vacío.
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 que uses 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.