Client de l'API Booking Java

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

Prérequis :

Faites créer votre compte de service, puis téléchargez votre clé privée.

Premiers pas :

  1. Téléchargez la bibliothèque cliente Java, puis décompressez le fichier pour obtenir le package "mapsbooking".
  2. Créez un projet Java dans votre IDE, puis téléchargez les exemples de code 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 à faire pour finaliser vos implémentations.

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

Dépannage :

  1. Lorsque vous essayez de créer un marchand/un 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. Lorsque vous effectuez un appel de remplacement de la disponibilité avec un merchantId ou un serviceId non valide, l'appel n'affiche pas de message d'erreur. En effet, les modifications apportées aux créneaux de disponibilité via les RTU sont compatibles avec l'exécution hors séquence et ne sont donc pas associées à un merchantId ou serviceId. Toutefois, les emplacements de la requête ne seront pas diffusés en production en raison du merchantId ou du serviceId non valide. Pour rendre les créneaux disponibles, 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 doit uniquement modifier les valeurs des champs comme spécifié dans le masque et laisser les autres inchangées. 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 pour tous les champs avait été spécifié). Par conséquent, si vous souhaitez mettre à jour tous les champs, définissez simplement updateMask sur vide.
  4. Tout champ dont la valeur est nulle n'est pas affiché dans la réponse.