Necesitas un servidor de reservas para permitir que el Centro de acciones realice devoluciones de llamada para crear y actualizar reservas en tu nombre. Esto permite que Actions Center cree citas y reservas en tu empresa en nombre del usuario.
Para obtener información sobre cómo configurar la conexión a tus servidores de reserva de zona de pruebas y producción, consulta Configura las credenciales del servidor de reservas.
Completa las siguientes tareas de preparación del servidor de reservas antes de pasar a las actualizaciones en tiempo real:
- Carga de la página BatchAvailabilityLookup lista
- BatchAvailabilityLookup slot click Ready
- CreateBooking Ready
- UpdateBooking Ready
- Habilita el verificador de disponibilidad en la sección Funciones de la cuenta de la configuración de Actions Center.
Cada tarea se marca como completada y se vuelve verde cuando envías detalles precisos del inventario en tiempo real a las solicitudes del servidor de reservas a través del flujo de reservas del entorno de pruebas. Los hitos del servidor de reservas se analizan durante un período de 14 días.
Implementa una interfaz de API de REST
Implementa una interfaz de API basada en REST. Esto permite que Google envíe solicitudes del servidor de reservas a través de HTTPS.
Para implementar una interfaz de API, configura un servidor de reservas de zona de pruebas o de desarrollo que se conecte al entorno de zona de pruebas de Actions Center. Solo migra a un entorno de producción una vez que hayas probado completamente el servidor de zona de pruebas.
Todas las solicitudes del servidor de reservas de Google se relacionan con la URL del servidor de reservas establecida en la página Servidor de reservas. Por ejemplo, si tu URL está configurada como api.example.com/google, todas las solicitudes de HealthCheck se envían a api.example.com/google/v3/HealthCheck.
Asegúrate de que el extremo del servidor de reservas correcto esté configurado para los entornos de zona de pruebas y producción con el selector de entornos.
Seguridad y autenticación
Toda la comunicación con tu servidor de reservas se realiza a través de HTTPS con autenticación básica. Para configurar tu servidor, te recomendamos que utilices una herramienta de verificación de SSL o TLS disponible públicamente, como la prueba de servidor SSL de Qualys.
Todas las solicitudes que Google realiza a tu servidor de reservas se autentican con la autenticación básica de HTTPS. Puedes ingresar la información de autenticación básica, la contraseña y el nombre de usuario de tu servidor de reservas en la página de configuración del servidor de reservas de Actions Center. Las credenciales se deben cambiar cada seis meses.
Compila tu servidor de reservas
El servidor de reservas determina cómo se comunica la integración con tu sistema y realiza o actualiza las reservas. Para configurar la conexión a tus servidores de reserva de zona de pruebas y producción, consulta Cómo configurar las credenciales del servidor de reserva.
Se espera que cada respuesta que tu servidor de reservas envíe a una solicitud de Reserva con Google contenga detalles precisos del inventario en tiempo real. En la siguiente tabla, se muestran los métodos para cada implementación y se incluyen vínculos a los formatos de protocolo de servicio:
| Método | Definición | Respuesta | Solicitud HTTP |
|---|---|---|---|
Carga de la página BatchAvailabilityLookup |
Cuando un usuario hace clic en Reservar una mesa para tu comercio, se llama a la solicitud La carga útil contiene numerosas ranuras basadas en tus cargas de feeds más recientes, que Reserva con Google considera disponibles. |
La respuesta debe incluir cada solicitud de ranura y la disponibilidad actual de la ranura. Esto evita que se muestren los espacios no disponibles. | POST /v3/BatchAvailabilityLookup/ |
BatchAvailabilityLookup clic en ranura |
Cuando se le presentan al usuario los horarios disponibles para reservar y hace clic en uno, se llama a la solicitud BatchAvailabilityLookup para el clic en el horario. |
La respuesta debe representar la disponibilidad actual y real del horario. Si se reserva antes de que se haga clic en el horario, devuelve la respuesta de que no está disponible. | POST /v3/BatchAvailabilityLookup/ |
CreateBooking |
Cuando un usuario confirma que desea reservar un horario seleccionado en el modal de reserva, se envía la solicitud CreateBooking. |
La respuesta debe representar el éxito o el fracaso de la reserva. Si la reserva falla, debes devolver el motivo específico del error. Por ejemplo, la ranura se reservó antes de que se llamara a la respuesta Si se crea una reserva exitosa, la respuesta incluye un |
POST /v3/CreateBooking/ |
UpdateBooking |
Después de que se realiza una reserva a través de Reserva con Google, el usuario puede optar por modificarla. Cuando el usuario actualiza o cancela su reserva, se envía una solicitud UpdateBooking. |
Al igual que la respuesta CreateBooking, tu respuesta a UpdateBooking debe representar el éxito de la reserva o mostrar el motivo específico de una falla. |
POST /v3/UpdateBooking/ |
HealthCheck |
El Centro de acciones realiza llamadas periódicas a tu servidor de reservas para confirmar que tu infraestructura esté activa y en funcionamiento. | Usa el código de estado HTTP para indicar el estado de entrega de tu servidor. Devuelve un código de estado HTTP 200 si el servidor está activo y se ejecuta correctamente. Para indicar un error o desconectar temporalmente tu integración, devuelve el código de estado HTTP no 2xx adecuado. |
GET /v3/HealthCheck/ |
Flujo de reserva de zona de pruebas
Para ver el flujo de reserva del entorno de pruebas, ve a la vista Inventario del Centro de acciones. La columna RwG - E2E de la vista Inventario muestra un vínculo En vivo (en zona de pruebas) al flujo de reserva de la zona de pruebas para los comercios de la zona de pruebas que están vinculados y tienen disponibilidad futura.
Las siguientes son las acciones en el flujo de reserva:
- Cuando haces clic en el vínculo RwG - E2E, se activa una solicitud de
BatchAvailabilityLookupen la carga de la página y se muestra la disponibilidad conocida del comercio. - Cuando haces clic en un horario de reserva, se activa la solicitud de
BatchAvailabilityLookupal hacer clic en la ranura y se presenta el modal de reserva. - Completa una reserva con el modal de reserva para enviar la solicitud
CreateBooking. - Después de completar una reserva en el entorno de pruebas, la cuenta que se usó para crearla recibe una confirmación por correo electrónico con los detalles de la reserva.
- Para activar el método
UpdateBooking, cambia o cancela la reserva desde el correo electrónico.
HealthCheck
Asegúrate de implementar el método HealthCheck en la zona de pruebas y en producción. Este método muestra el estado de tu servidor de reservas. Permite que Google supervise continuamente el estado de entrega de tu servidor de reservas.
Solicitud: Ninguno
Valor que se devuelve: Ninguno
Usa el código de estado HTTP para indicar el estado de entrega de tu servidor.
Si el servidor está activo y se ejecuta correctamente, muestra un código de estado HTTP 200 o, para indicar un error, muestra uno de los códigos de estado HTTP.