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. Nos artefacts sont publiés dans le dépôt central Maven.
Nous vous recommandons d'utiliser la nomenclature des composants de l'API Google Ads (BOM) pour gérer les versions des dépendances.
Vous pouvez également effectuer une compilation à partir de la source. Pour les besoins de ce guide, nous partons du principe que vous disposez d'un projet configuré avec les dépendances requises.
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 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, nous allons exécuter 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"
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 INSERT_XXXXX_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 répertorier 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'