El inventario en tu sistema cambia debido a la creación de nuevas reservas, las cancelaciones y los cambios en los horarios de tus comercios. La API de Real-Time Update (RTU) es un mecanismo para notificarle a Google sobre estos cambios y los cambios realizados en las reservas existentes.
Se requieren RTU en los siguientes casos:
- Cuando un usuario cancela una reserva en tu sistema y el horario queda disponible.
- Cuando un usuario reserva a través del Centro de acciones y el horario ya no está disponible.
- Cuando se cancela una reserva realizada a través de Actions Center. Un ejemplo de situación incluye una cancelación por parte del comercio directamente. Debes actualizar la reserva y la disponibilidad, ya que el horario original está disponible.
Completa la siguiente tarea de hito de RTU antes de pasar a la revisión de Sandbox:
Cada tarea se marca como completada y se vuelve verde cuando las últimas 20 solicitudes no tienen errores durante un período de 14 días. Sigue enviando solicitudes exitosas para asegurarte de que el hito permanezca en verde.
Feeds y RTU de la API
Las RTU de la API le notifican a Google sobre los cambios incrementales en la disponibilidad del inventario y las reservas en tiempo real. Además de las RTU, envía feeds de disponibilidad completos todos los días. Esto garantiza que Google tenga la información de disponibilidad más precisa y actualizada de tu sistema. Los feeds completos actúan como un resumen del estado más reciente de la disponibilidad del inventario en tu sistema.
Para obtener más información, consulta los siguientes recursos:
Accede a la API
Tu proyecto de Google Cloud es la forma en que accedes a la API de Maps Booking del Centro de acciones, que es la forma en que envías las RTU. Debes usar una Cuenta de Google en la consola de Google Developers y proporcionar tu número de proyecto de Cloud en el hito de configuración de tu plan de incorporación. Para obtener más información sobre cómo habilitar las APIs de Cloud, consulta Habilita las APIs de Cloud.
Utiliza llamadas RESTful o descarga la biblioteca cliente
Te recomendamos que realices llamadas RESTful directamente a la API de Maps Booking con cargas útiles JSON. Para obtener más información, consulta la documentación de la API de REST.
También puedes utilizar bibliotecas cliente para conectarte a la API.
.| Idioma | Vínculo de descarga |
|---|---|
| Java | Biblioteca cliente de Java. Para obtener más información, consulta las instrucciones del cliente de Java. |
Hay bibliotecas de compatibilidad adicionales disponibles para su descarga que controlan la autorización y otros aspectos de las llamadas a las APIs de Google. Para obtener más información, consulta Muestras de código.
Obtén el documento de descubrimiento
Para algunas bibliotecas cliente, como Ruby, es necesario recuperar el documento de descubrimiento de la API, en el que se describen sus métodos y parámetros.
Para recuperar el documento de Discovery, usa el siguiente comando:
curl -s -o mapsbooking_rest
https://mapsbooking.googleapis.com/$discovery/rest?version=v1alpha
Para obtener más información sobre cómo acceder a la API desde Ruby, consulta Cliente de API de Ruby y Biblioteca de Auth de Ruby.
Realiza llamadas autorizadas a la API
Cuando realices llamadas a la API, consulta Cómo prepararse para realizar una llamada a la API delegada para autorizar tu cuenta de servicio con tu clave privada y el siguiente alcance de OAuth:
https://www.googleapis.com/auth/mapsbooking
Extremos en los entornos de producción y zona de pruebas
Puedes realizar llamadas a los entornos de producción y zona de pruebas a través de la API. Asegúrate de habilitar ambas APIs en tu proyecto de Google Cloud. Ambas APIs usan el mismo alcance, pero tienen extremos diferentes.
Extremo de producción: https://mapsbooking.googleapis.com/
Extremo de zona de pruebas: https://partnerdev-mapsbooking.googleapis.com/
A continuación, se incluye un ejemplo en Java de cómo cambiar los extremos:
// This block of code is for OAuth and is the same for prod and sandbox.
GoogleCredential
.fromStream(new FileInputStream(...))
.createScoped(Collections.singleton("https://www.googleapis.com/auth/mapsbooking"))
// This block of code sets the endpoint. This is what you'd change to connect to the sandbox.
new GoogleMapsBookingAPI.Builder(...)
.setApplicationName(...)
.setRootUrl("https://partnerdev-mapsbooking.googleapis.com/") // you add this to change the endpoint to use partnerdev.
.build()