La bibliothèque cliente pour Java est hébergée sur GitHub et distribuée via Maven Central. Elle offre plusieurs fonctionnalités pour vous aider à utiliser l'API, y compris une gestion plus simple des identifiants et la création de clients de service de l'API Google Ads.
La bibliothèque nécessite Java 8 ou une version ultérieure.
Installation
Utilisez la nomenclature de l'API Google Ads dans votre fichier pom.xml ou build.gradle pour gérer les versions des dépendances :
<!-- Import the Bill of Materials (BOM) to ensure you're using compatible
versions of all google-ads libraries. -->
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>google-ads-bom</artifactId>
<version>48.1.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<!-- Add the google-ads dependency, without a version. The version is
managed by the BOM. -->
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>google-ads</artifactId>
</dependency>
Vous pouvez également compiler la bibliothèque à partir de la source.
Effectuer votre premier appel d'API
Pour utiliser l'API Google Ads, vous devez suivre plusieurs étapes afin d'accéder à l'API et de configurer vos comptes Google Ads. Suivez le guide de démarrage rapide, qui vous présente toutes les étapes importantes, y compris la configuration de vos comptes Google Ads.
Utilisation de base
Consultez le guide d'utilisation de base pour savoir comment configurer un projet, instancier des clients de service et exécuter des exemples de code avec la bibliothèque cliente Java.
Authentification et autorisation
La bibliothèque cliente Java accepte plusieurs approches d'authentification et d'autorisation, y compris les flux d'applications Web et de bureau OAuth 2.0, les comptes de service et les identifiants par défaut de l'application. Pour en savoir plus, consultez le guide sur l'authentification et l'autorisation.
Configuration et journalisation
La bibliothèque cliente Java est compatible avec plusieurs options de configuration (y compris les fichiers ads.properties, les variables d'environnement et la configuration programmatique) et des fonctionnalités de journalisation pour le traçage des requêtes et des réponses de l'API.
Utilitaires
La bibliothèque cliente Java inclut des classes d'utilitaires pour améliorer la facilité d'utilisation de l'API. Pour en savoir plus, consultez les guides suivants :
- FieldMasks : outils d'aide pour créer et calculer des masques de champ de mise à jour.
- ResourceNames : utilitaires permettant de mettre en forme les chaînes de nom de ressource d'entité.
- Opérations de longue durée : outils d'aide pour surveiller et gérer les opérations d'API asynchrones.
Affiner votre application
Consultez le guide d'utilisation avancée pour obtenir des recommandations sur la façon d'ajuster les délais avant expiration, les paramètres de nouvelle tentative, la latence de démarrage et la gestion des dépendances de votre application.