Voici comment utiliser 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 répertoire central Maven.
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é-empaqueté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 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 d'authentification et d'autorisation.
Effectuer votre premier appel
Une fois que vous avez configuré vos identifiants, vous pouvez 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.
Commencez par accéder au répertoire google-ads-examples :
cd google-ads-examples
Cet exemple nécessite un paramètre --customerId dont la valeur est le 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 de 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'