Cómo realizar autenticaciones con la API de Maps Booking

Para realizar actualizaciones en tiempo real, debes realizar solicitudes a la API de reservas de Maps. La API de Maps Booking requiere que autentiques tus solicitudes mediante OAuth 2.0 con una cuenta de servicio de GCP que tenga acceso a la API y que se le hayan asignado las QPS necesarias. En esta guía, se explican los pasos que debes seguir para realizar las siguientes acciones:

  1. Configura el proyecto de Google Cloud
  2. Crea una cuenta de servicio
  3. Habilita la API de Maps Booking en tu proyecto de GCP
  4. Cómo depurar problemas comunes

Para obtener información sobre cómo realizar solicitudes a la API, consulta nuestra sección Actualizaciones en tiempo real de la API de la guía de extremo a extremo.

Configura tu proyecto de Google Cloud con Reserva con Google

  1. Accede a tu cuenta de Google Cloud Platform.
  2. Puedes crear un proyecto nuevo o usar uno existente para este propósito.
    • Anota el número de proyecto de la nube, ya que lo necesitarás en los próximos pasos. También puedes encontrar el número de tu proyecto de Cloud en la página principal de Google Cloud Platform. El número de proyecto de la nube siempre es numérico.
  3. Accede al Portal para socios.
  4. Completa el paso 1 en la página Tareas de integración del Portal para socios. Para ello, envía el número y la dirección de correo electrónico del proyecto en la nube (la dirección de correo electrónico que se usa para administrar el proyecto en la nube).

Crea una cuenta de servicio y credenciales de OAuth

  1. Vuelve a acceder a tu cuenta de Google Cloud Platform.
  2. Dirígete a IAM & admin; cuentas de servicio.
  3. Busca tu ID del proyecto de Cloud existente o recientemente creado.
  4. Crea una cuenta de servicio.
  5. Completa los detalles de la cuenta de servicio.
  6. Asigna a la cuenta de servicio nueva la función más adecuada para las necesidades de tu aplicación. La elección de una función para la cuenta de servicio no tendrá ningún efecto sobre las llamadas que se pueden hacer a la API de reservas de Google Maps, ya que la asignación de una cuota suficiente para usarlas se determina mediante la asociación del número de proyecto en la configuración de Reserva con Google. Si no estás seguro de qué función elegir, elige Proyecto > Visualizador.
  7. Después de hacer clic en “Continuar” en el paso (6), se te dará la opción de crear claves JSON.
  8. Guarde las credenciales json. Asegúrate de almacenarlos en un lugar seguro, ya que no podrás recuperarlos más tarde.
  9. Vuelve a acceder al Portal para socios y completa las tareas restantes en la página Tareas de integración.

Habilitar la API de MapsBooking

  1. Accede a tu cuenta de Google Cloud Platform.
  2. Dirígete a API &Services > Dashboard.
  3. Haz clic en Habilitar API y servicios y busca Google Maps Booking API.
  4. Habilita las siguientes API:
    • API de Google Maps Booking
    • API de Google Maps Booking (desarrollo)

Errores comunes

Existen varios motivos por los que puedes tener problemas de autorización cuando realizas solicitudes de actualización en tiempo real. Si necesitas orientación general sobre cómo realizar solicitudes de actualizaciones en tiempo real, consulta la sección Actualizaciones de la API en tiempo real de la guía de extremo a extremo. También puedes encontrar clientes de muestra en varios lenguajes en la sección Muestras de código.

Si encuentras errores 403, verifica que cumplas con todos los siguientes requisitos:

  1. Usa una biblioteca cliente de Google.
  2. Crea credenciales de OAuth con la autenticación de la cuenta de servicio.
  3. Autoriza el alcance adecuado.
  4. Realiza llamadas al extremo adecuado (enumerado a continuación).

Asegúrate de realizar llamadas al extremo correcto:

  1. Zona de pruebas: https://partnerdev-mapsbooking.googleapis.com/v1alpha/...
  2. Producción: https://mapsbooking.googleapis.com/v1alpha/...

Asegúrate de autorizar correctamente tus solicitudes de credenciales de OAuth:

  1. Estás autorizando el alcance &https://www.googleapis.com/auth/mapsbooking".
  2. Usas la clave de la cuenta de servicio que creaste en Crea una cuenta de servicio y credenciales de OAuth.

¿Todavía ves errores?

Si sigues viendo errores después de seguir estos pasos, comunícate con tu contacto de Reserva con Google con la siguiente información:

  • ID y proyecto del proyecto de Cloud con una captura de pantalla
  • ID de la cuenta de servicio
  • Correo electrónico que se usó para crear la cuenta de servicio
  • Los detalles del punto final intentaron realizar solicitudes a
  • Hora de los intentos de solicitud
  • Mensajes de error y solicitudes completos recibidos al hacer solicitudes.