Introducción a las listas de espera

Los socios que participan en el programa de lista de espera deben completar la configuración de la cuenta antes de comenzar. Sin embargo, algunos pasos de la guía general no son necesarios para usar la función de listas de espera. Los lineamientos de esta página explican qué pasos aplican a los socios interesados en usar la función de listas de espera en Reserva con Google. Te sugerimos que leas esta descripción general antes de seguir con los pasos de la integración.

Proceso de lanzamiento

En la figura 1, se describe el proceso para lanzar tus comercios habilitados para utilizar listas de espera en Reserva con Google.

Figura 1: Pasos para la integración de alto nivel
Figura 1: Pasos de integración de alto nivel

En general, los principales flujos de datos entre tú (el socio) y Google se muestran en la Figura 2:

Figura 2: Diagrama de flujo de datos de la integración
Figura 2: Diagrama de flujo de datos de la integración

Lineamientos para todos los socios que usan listas de espera

Ten en cuenta lo siguiente cuando implementes la función de listas de espera:

  • El servicio de todos los comercios que usan listas de espera debe tener waitlist_rules propagado.
    • Debes usar el mismo servicio para la lista de espera y la reserva. En otras palabras, si tu restaurante también permite hacer reservas, simplemente agrega los metadatos relacionados con la lista de espera al servicio para esta.
  • El envío de actualizaciones por SMS es obligatorio para la implementación de listas de espera en los siguientes casos:
    • Para confirmar que el usuario se unió correctamente a la lista de espera.
    • Para notificar al usuario que su tabla está lista.
    • Para notificar al usuario que se canceló su entrada a la lista de espera.
  • Los mensajes SMS deben incluir un vínculo a una página donde los usuarios puedan ver el estado de sus listas de espera.
  • Los comercios que solo usan listas de espera no necesitan proporcionar feeds de disponibilidad a Reserva con Google.
  • Tu servidor de reservas debe implementar todos los pasos específicos de la lista de espera que se indican en Cómo implementar el servidor de reservas. Los socios que admiten reservas y listas de espera pueden agregar los nuevos métodos a su servidor de reservas existente.
  • Reserva con Google ejecuta un conjunto de casos de prueba para los métodos de lista de espera en el servidor de reservas.

Diagrama de flujo de estado

En este gráfico, se describen los estados que se deben informar en WaitlistEntry.waitlist_entry_state cuando se responden las llamadas de GetWaitlistEntry . El gráfico también indica cuándo registrar y propagar los campos WaitlistEntry.waitlist_entry_state_times.*_time_seconds y cuándo enviar un SMS al usuario para informarle que ingresó en un nuevo estado.

Figura 3: Diagrama de flujo del estado de la lista de espera
Figura: 3 Diagrama de flujo del estado de la lista de espera

Casos extremos comunes

Los siguientes son casos extremos comunes en una integración de lista de espera y las soluciones preferidas para ellos.

  • Si algunos tamaños de grupo (pero no todos) no aceptan nuevas incorporaciones a la lista de espera porque no hay tiempo de espera en estos tamaños, se mostrará WaitEstimates para todos los tamaños en la respuesta BatchGetWaitEstimates y se permitirá a los usuarios unirse a la lista para estos tamaños sin espera. Muestra un WaitLength con 0 parties_ahead_count o un estimated_seat_time_range con 0 start_seconds y con 0 end_seconds para los party_size sin espera.
  • Si uno o más tamaños de grupo no aceptan nuevas incorporaciones a la lista de espera porque la espera se volvió demasiado larga, es preferible omitir WaitEstimates para esos tamaños en la respuesta BatchGetWaitEstimates.

Se prefiere usar estos enfoques, ya que brindan opciones al usuario aunque la lista de espera del comercio no esté completamente abierta.

Lineamientos para socios que solo usan listas de espera

Ten en cuenta lo siguiente si el servidor de reservas se usa solo para listas de espera:

  • Los socios que solo usan listas de espera no proporcionan feeds de disponibilidad a Reserva con Google.
  • Los socios que solo usan listas de espera no implementan los métodos de reserva en su servidor de reservas. En su lugar, debes implementar el servidor de reservas con las instrucciones para la implementación de listas de espera.
  • Los socios que solo usan listas de espera no realizan llamadas a la API a Google. Esto significa que los socios exclusivos de listas de espera no necesitan configurar proyectos en la nube ni proporcionar una dirección de correo electrónico de desarrollador. No es necesario que completes las actualizaciones de la API en tiempo real. Sin embargo, aún se deben proporcionar los feeds de comercio y servicio a Reserva con Google.

Lineamientos para socios cuyos comercios deben aceptar o rechazar manualmente las incorporaciones a listas de espera

Si tus comercios requieren la capacidad de aceptar o rechazar manualmente las nuevas incorporaciones a listas de espera de Google, se requieren pasos adicionales:

  • Configura waitlist_confirmation_mode como WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS en wait_estimate para los tamaños de grupo que requieren confirmación manual. Debe configurarse en BatchGetWaitEstimateResponse y GetWaitlistEntryResponse.
  • Las entradas de lista de espera que haya solicitado el usuario, pero que el comercio aún no haya aceptado deben tener el estado PENDING_MERCHANT_CONFIRMATION.

Casos de prueba de listas de espera

Google prueba los siguientes casos prácticos para garantizar la funcionalidad de los métodos de las listas de espera en la implementación del servidor de reservas. Google también prueba y supervisa la latencia. Todas estas pruebas deben aprobarse antes del lanzamiento.

Recuperación de WaitEstimate

  • Las estimaciones del tiempo de espera se muestran para cada tamaño de grupo solicitado en un BatchGetWaitEstimatesRequest.
  • En el caso de los tamaños de grupo para los que el comercio tiene la opción de aceptar o rechazar nuevas incorporaciones a la lista de espera, configura list_confirmation_mode como WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS.

Creación de entradas de lista de espera

  • Se puede crear una entrada de lista de espera desde una solicitud CreateWaitlistEntry.
  • Si la creación de una entrada de lista de espera falla, aparecerá un error de lógica empresarial en la respuesta.
  • Si un intento de CreateWaitlistEntry se ejecuta correctamente, se mostrará la misma respuesta cuando se vuelva a recibir el mismo CreateWaitlistEntry.
  • Si un intento de CreateWaitlistEntry falla, el servidor vuelve a intentarlo cuando se recibe el mismo CreateWaitlistEntry.
  • Las entradas de lista de espera aparecen en la interfaz del comercio.
  • Las llamadas a GetWaitlistEntry muestran correctamente la entrada de lista de espera creada.

Estados y marcas de tiempo de las entradas de lista de espera

  • Verifica que cada estado de entrada de lista de espera se muestre correctamente en la entrada de lista de espera de las respuestas GetWaitlistEntry.
  • Verifica que cada marca de tiempo del estado esté configurada en el campo de marca de tiempo adecuado de la entrada de la lista de espera en las respuestas de GetWaitlistEntry.

Eliminación de entradas de lista de espera

  • Es posible borrar entradas de lista de espera existentes. La respuesta a una eliminación exitosa debe ser el proto {}.

Inhabilitar

Ejemplo de feed de servicio de lista de espera (JSON)

Feed de servicio de lista de espera

Inhabilitación de comercios

Google espera ciertas respuestas de los comercios que anteriormente tenían listas de espera habilitadas, pero decidieron inhabilitarlas.

Inhabilitación inmediata

Inhabilitación extendida

  • Quita el waitlist_rules del feed de servicios del comercio si este no inhabilita las reservas.
  • Quita al comercio del feed de comercio si inhabilita todas las integraciones de Google.