Cliente de la API de Java Booking

Puedes descargar nuestro cliente de la API de actualización en tiempo real de Java para ayudarte a comenzar a implementar las actualizaciones en tiempo real.

Requisitos:

Haz que crees una cuenta de servicio, descarga tu clave privada.

Comienza ahora:

1. Descarga la biblioteca cliente de Java y descomprime el archivo para obtener el paquete “mapsbooking”.

2. Crea un proyecto de Java en tu IDE, descarga los códigos de muestra InventoryUpdate.java y BookingNotification.java de este repositorio:

   git clone https://maps-booking.googlesource.com/java-maps-booking-api-example
   

   e impórtalos a tu proyecto Java en el directorio src.

3. Haz una copia de tu clave privada (archivo JSON) en el directorio src.
4. Agrega la biblioteca cliente de Java a las dependencias de tu proyecto (incluye archivos JAR en el directorio mapbooking y libs-sources).
5. En ambos archivos Java, sigue los TODO para completar tus implementaciones

Puedes obtener más detalles sobre la API de REST aquí.

Solución de problemas:

1. Cuando intentes crear un comercio o servicio nuevo con un merchantId o serviceId existente, recibirás el siguiente mensaje de error:

   409 Conflict
   {
     “code” : 409,
     “errors” :
       [{
           “domain” : “global”,
           “message” : “Requested entity already exists”,
           “reason” : “alreadyExists”,
           “debugInfo” : “detail: "[ORIGINAL ERROR] generic::already_exists: ...”\n"
       }],
     “message” : “Requested entity already exists”,
     “status” : “ALREADY_EXISTS”
   }
   

2. Cuando se realiza una llamada de reemplazo de disponibilidad con un merchantId o serviceId no válido, la llamada no arrojará un mensaje de error. Esto se debe a que los cambios en los horarios disponibles a través de las RTU admiten la ejecución desordenada y, por lo tanto, no están asociados con un merchantId o serviceId. Sin embargo, las ranuras de la solicitud no se entregarán en la producción debido a un merchantId o serviceId no válido. Para que las ranuras se puedan publicar, agrega el comercio o servicio que falta mediante las RTU o los feeds.
3. En todas las funciones de actualización, el parámetro "updateMask" debe estar en formato FieldMask para especificar los campos que se actualizarán. La API solo debe cambiar los valores de los campos según lo especificado en la máscara y dejar los demás intactos. Si pasas la string updateMask incorrecta, la actualización no tendrá efecto. Si una máscara de campo no está presente en la actualización, la operación se aplica a todos los campos (como si se especificara una máscara de campo de todos los campos). Por lo tanto, si deseas actualizar todos los campos, establece el campo updateMask vacío.
4. Los campos que tengan el valor cero no se mostrarán en la respuesta.