Exemple de client Java

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

Prérequis :

Créez votre compte de service et téléchargez votre clé privée.

Premiers pas :

  1. Téléchargez le Décompressez le fichier dans la bibliothèque cliente Java pour obtenir le fichier "mapsbooking". d'un package.
  2. Créez un projet Java dans votre IDE et 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 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. Ajouter la bibliothèque cliente Java aux dépendances de votre projet (inclure les fichiers JAR dans les répertoires mapsbooking et libs-sources).
  5. Dans les deux fichiers Java, suivez les instructions de la section "TODO" pour finaliser vos implémentations.

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

Dépannage :

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

    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 disponibilité de remplacement avec un merchantId non valide ou serviceId, l'appel ne renverra pas de message d'erreur. En effet, les modifications apportées aux créneaux de disponibilité via des mises à jour en temps réel permettent une exécution dans le désordre. et n'est donc pas associé à un merchantId ni à serviceId. Toutefois, les emplacements de la requête ne seront pas diffusées dans l'environnement de production, car les merchantId ou serviceId. Pour rendre les emplacements diffusables, veuillez ajouter le paramètre marchand ou service manquant via des mises à jour en temps réel ou des flux.
  3. Dans toutes les fonctions de mise à jour, le paramètre "updateMask" doit être FieldMask pour spécifier les champs à mettre à jour. L'API est Obligatoire pour modifier uniquement les valeurs des champs comme spécifié dans le masque sans toucher aux autres. Si vous transmettez une 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 spécifié). Pour mettre à jour tous les champs, updateMask vide.
  4. Tout champ ayant une valeur nulle n'est pas affiché dans la réponse.