Voici l'utilisation de base de la bibliothèque cliente Java :
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épackagés inclus dans le module google-ads-examples, clonez le dépôt google-ads-java depuis GitHub ou compilez à partir de la source. Si vous effectuez une compilation à 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 d'authentification et d'autorisation.
Effectuer votre premier appel
Une fois vos identifiants configurés, vous êtes prêt à effectuer votre premier appel d'API.
Pour valider vos identifiants et effectuer votre premier appel à l'aide du dépôt google-ads-java cloné, exécutez l'exemple GetCampaigns.
Accédez d'abord au répertoire google-ads-examples :
cd google-ads-examples
Cet exemple nécessite un paramètre --customerId dont la valeur correspond au numéro client de votre 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 examples 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 des espaces réservés INSERT_..._HERE dans le code source. Pour afficher un énoncé d'utilisation pour 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'