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 (BOM) de l'API Google Ads pour gérer les versions des dépendances.
Vous pouvez également compiler à partir de la source. Pour les besoins de ce guide, nous partons du principe que vous avez configuré un projet avec les dépendances requises disponibles.
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 sur l'authentification et l'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, nous allons exécuter 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 correspond à votre numéro client 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 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 INSERT_XXXXX_HERE dans le code source. Pour afficher une déclaration 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'