JAVA REST

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

Requisito:

Crea tu cuenta de servicio y 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 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

    y, luego, importarlos a tu proyecto de Java en el directorio src.

  3. Crea 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 mapsbooking y libs-sources).
  5. En ambos archivos Java, sigue las tareas pendientes para completar las implementaciones.

Aquí puedes encontrar más detalles sobre la API de REST.

Solución de problemas:

  1. Cuando intentes crear un comercio o servicio nuevo con un merchantId o serviceId existentes, 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 realices una llamada de reemplazo de disponibilidad con un merchantId o serviceId no válidos, la llamada no arrojará un mensaje de error. Esto se debe a que los cambios en los horarios de disponibilidad a través de las RTUs admiten la ejecución fuera de orden y, por lo tanto, no están asociados con un merchantId o serviceId. Sin embargo, los horarios de la solicitud no se publicarán en producción debido a que merchantId o serviceId no son válidos. Para que los horarios se puedan publicar, agrega el comercio o servicio faltante a través de las RTUs 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 como se especifica en la máscara y dejar los demás sin cambios. Si pasas la cadena de updateMask incorrecta, la actualización no se aplicará. Si no hay una máscara de campo en la actualización, la operación se aplica a todos los campos (como si se hubiera especificado una máscara de campo para todos los campos). Por lo tanto, si deseas actualizar todos los campos, simplemente deja el campo updateMask vacío.
  4. Cualquier campo que tenga un valor cero no se mostrará en la respuesta.