Client de l'API Booking Java

Vous pouvez télécharger notre client d'API de mise à jour en temps réel Java pour commencer à implémenter les mises à jour en temps réel.

Conditions préalables :

Une fois votre compte de service créé, téléchargez votre clé privée.

Premiers pas :

  1. Téléchargez la bibliothèque cliente Java afin de décompresser 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
    

    et importez-les dans votre projet Java, dans 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 le répertoire mapsbooking et libs-sources).
  5. Dans les deux fichiers Java, suivez les tâches à effectuer pour implémenter

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

Dépannage :

  1. Lorsque vous essayez de créer un marchand/service avec un ID de marchand ou un ID de service 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 remplacement disponible avec une valeur merchantId ou serviceId non valide, l'appel ne génère pas de message d'erreur. En effet, les modifications apportées aux emplacements de disponibilité via des RTU permettent l'exécution dans le désordre et ne sont donc pas associées à un merchantId ni à serviceId. Toutefois, les emplacements de la requête ne seront pas diffusés dans l'environnement de production en raison d'un ID de marchand ou d'un ID de service 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 est uniquement requise pour modifier les valeurs des champs comme spécifié dans le masque et laisser les autres tel quel. Si vous transmettez la chaîne updateMask incorrecte, la mise à jour ne sera pas prise en compte. 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 laisser le champ updateMask vide.
  4. Les champs qui ont une valeur égale à zéro n'apparaissent pas dans la réponse.