Rejoignez-nous en direct sur Discord sur le serveur de la communauté Google Advertising and Measurement et sur YouTube le 15 octobre à 16h (heure française) ! Nous aborderons les nouvelles fonctionnalités ajoutées dans la version 26 de l'API Google Ads.

Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Utilisation de base

L'utilisation de base de la bibliothèque cliente Java est la suivante :

Créer un projet Maven ou Gradle

Créez un projet Maven ou Gradle dans l'IDE de votre choix. Les artefacts sont publiés dans le dépôt Maven Central.

Utilisez la nomenclature de l'API Google Ads pour gérer les versions des dépendances.

Si vous souhaitez exécuter les exemples de code préemballés inclus dans le google-ads-examples module, clonez le google-ads-java dépôt depuis GitHub ou compilez-le à partir de la source. Si vous compilez à partir de la source, assurez-vous d'activer le traitement des annotations dans votre IDE.

Configurer l'accès à l'API

Pour vous connecter à l'API Google Ads, vous devez fournir des identifiants d'authentification et d'autorisation. Pour en savoir plus sur les identifiants requis et sur la configuration de la bibliothèque cliente, consultez le guide Authentification et autorisation.

Effectuer votre premier appel

Une fois vos identifiants configurés, vous pouvez effectuer votre premier appel d'API.

Pour valider vos identifiants et effectuer votre premier appel à l'aide du dépôt cloné google-ads-java, exécutez l'exemple GetCampaigns.

Tout d'abord, accédez au répertoire google-ads-examples :

cd google-ads-examples

Cet exemple nécessite un paramètre --customerId dont la valeur correspond à votre ID client de compte Google Ads sans tirets (-).

Pour exécuter avec Gradle :

./gradlew -q runExample \
  --example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"

Pour exécuter avec Maven :

mvn exec:java \
  -Dexec.mainClass="com.google.ads.googleads.examples.basicoperations.GetCampaigns" \
  -Dexec.args="--customerId INSERT_CUSTOMER_ID_HERE"

Découvrir d'autres exemples

Le package d'exemples dans google-ads-examples contient plusieurs exemples utiles. La plupart des exemples nécessitent des paramètres. Vous pouvez transmettre les paramètres en tant qu'arguments (recommandé) ou modifier les valeurs d'espace réservé INSERT_..._HERE dans le code source. Pour afficher une instruction d'utilisation d'un exemple, transmettez --help comme seul argument.

Avec Gradle :

./gradlew -q runExample --example="basicoperations.GetCampaigns --help"

Vous pouvez également utiliser la tâche listExamples dans Gradle pour lister tous les exemples, les exemples d'un sous-répertoire ou les exemples dont la description inclut un terme de recherche :

# List all examples:
./gradlew -q listExamples
# List examples in the 'basicoperations' subdirectory:
./gradlew -q listExamples --subdirectory='basicoperations'
# Search for examples where the description includes 'Performance Max':
./gradlew -q listExamples --searchTerm='Performance Max'