JAVA REST

Vous pouvez télécharger notre client API Java Real Time Update pour commencer à implémenter les mises à jour en temps réel.

Conditions préalables :

Téléchargez votre clé privée après avoir créé votre compte de service.

Premiers pas :

  1. Téléchargez la bibliothèque cliente Java en décompressant le fichier pour obtenir le package "mapsbooking".
  2. Créez un projet Java dans votre IDE, puis téléchargez les exemples de codes InventoryUpdate.java et BookingNotification.java à partir de ce dépôt:

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

    puis les importer dans votre projet Java sous le répertoire "src".

  3. Créez une copie de votre clé privée (fichier JSON) dans le répertoire src.
  4. Ajoutez la bibliothèque cliente Java aux dépendances de votre projet (incluez les fichiers JAR dans les répertoires "mapsbooking" et "libs-sources").
  5. Dans les deux fichiers Java, suivez les instructions à l'écran pour terminer vos implémentations.

Pour en savoir plus sur l'API REST, cliquez ici.

Dépannage :

  1. Lorsque vous essayez de créer un marchand/service avec un merchantId ou un serviceId existant, le message d'erreur suivant s'affiche:

    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. Lors d'un appel de la disponibilité de remplacement avec un merchantId ou serviceId non valide, l'appel ne génère pas de message d'erreur. En effet, les modifications apportées aux créneaux de disponibilité via les RTU permettent une exécution non ordonnée et ne sont donc pas associées à un merchantId ni à un serviceId. Toutefois, les emplacements de la requête ne seront pas diffusés en production en raison d'un merchantId ou serviceId non valide. Pour rendre les emplacements diffusables, veuillez ajouter le marchand ou le service manquant via des RTU ou des flux.
  3. Dans toutes les fonctions de mise à jour, le paramètre "updateMask" doit être au format FieldMask pour spécifier les champs à mettre à jour. L'API ne doit modifier que les valeurs des champs spécifiées dans le masque et ne pas modifier les autres. Si vous transmettez la mauvaise chaîne updateMask, la mise à jour ne sera pas appliquée. Si aucun masque de champ n'est présent lors de la mise à jour, l'opération s'applique à tous les champs (comme si un masque de champ de tous les champs avait été spécifié). Par conséquent, si vous souhaitez mettre à jour tous les champs, il vous suffit de vider le champ updateMask.
  4. Les champs ayant une valeur nulle ne s'affichent pas dans la réponse.