Necesitas un servidor de reservas para permitir que Actions Center 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 página de BatchAvailabilityLookup: Listo
- Clic en el espacio de BatchAvailabilityLookup: Listo
- CreateBooking: Listo
- UpdateBooking: Listo
- Habilita el verificador de disponibilidad en la configuración de Actions Center Funciones de la cuenta
Cada tarea se marca como completada y se vuelve verde cuando envías detalles de inventario precisos y en tiempo real a las solicitudes del servidor de reservas a través del flujo de reserva de la zona 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
HealthCheck solicitudes se enviarán a api.example.com/google/v3/HealthCheck.
Asegúrate de que el punto de acceso correcto del servidor de reservas esté configurado para los entornos de zona de pruebas y producción con el selector de entorno.
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 realice 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 la integración se comunica 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 Configura las credenciales del servidor de reservas.
Se espera que cada respuesta que tu servidor de reservas realice a una solicitud de Reserva con Google contenga detalles de inventario precisos y 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 página de BatchAvailabilityLookup |
Cuando un usuario hace clic en Reservar una mesa para tu comercio, se llama a la solicitud
La carga útil contiene varios espacios que se basan en tus cargas de feed más recientes, que Reserva con Google considera disponibles. |
La respuesta debe incluir cada solicitud de espacio y la disponibilidad actual del espacio. Esto evita que se muestren los espacios no disponibles. | POST /v3/BatchAvailabilityLookup/ |
Clic en el espacio de BatchAvailabilityLookup |
Cuando se le presentan al usuario los espacios disponibles para reservar y hace clic en un
espacio, se llama a la solicitud BatchAvailabilityLookup para el clic en el espacio. |
La respuesta debe representar la disponibilidad actual y real del espacio. Si se reserva antes de que se haga clic en el espacio, muestra la respuesta de que no está disponible. | POST /v3/BatchAvailabilityLookup/ |
CreateBooking |
Cuando un usuario confirma que quiere 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 mostrar el
motivo específico de la falla. Por ejemplo, el espacio se reservó antes de que se llamara a la
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, un 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 |
Actions Center 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. Muestra un código de estado HTTP 200 si el servidor está activo y funcionando correctamente. Para indicar un error o desconectar temporalmente tu integración, muestra el código de estado HTTP no 2xx adecuado. |
GET /v3/HealthCheck/ |
Criterios de hitos
Para completar el hito de preparación del servidor de reservas, tu integración debe cumplir con los siguientes criterios en los entornos de zona de pruebas y producción:
| Método | Cantidad de solicitudes obligatoria (zona de pruebas) | Cantidad de solicitudes obligatoria (producción) | Tasa de éxito obligatoria |
|---|---|---|---|
Carga de página de BatchAvailabilityLookup |
20 | 20 | 90% |
Clic en el espacio de BatchAvailabilityLookup |
20 | 20 | 90% |
CreateBooking |
10 | 3 | 90% |
UpdateBooking |
10 | 3 | 90% |
Flujo de reserva de la zona de pruebas
Para ver el flujo de reserva de la zona de pruebas, ve a la vista de inventario de Actions Center Inventory. La columna RwG - E2E de la vista de inventario muestra un vínculo En vivo (en la zona de pruebas) al flujo de reserva de la zona de pruebas para los comercios de la zona de pruebas que coinciden 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
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
BatchAvailabilityLookupen el clic en el espacio y se muestra 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 zona de pruebas, la cuenta que se usó para crear la reserva recibe un correo electrónico de confirmación 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 la 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 funciona correctamente, muestra un código de estado HTTP 200, o muestra otro de los códigos de estado HTTP para indicar un error.