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 facile 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.0.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 créer la bibliothèque à partir de la source.
Effectuez votre premier appel d'API
Pour utiliser l'API Google Ads, vous devez suivre plusieurs étapes pour y accéder et configurer vos comptes Google Ads. Suivez le guide de démarrage rapide, qui vous explique toutes les étapes importantes, y compris la configuration de vos comptes Google Ads.
Utilisation de base
Consultez le guide d'utilisation de base pour découvrir 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 est compatible avec 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 d'authentification et d'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 les fonctionnalités de journalisation pour le suivi des requêtes et des réponses de l'API.
Utilitaires
La bibliothèque cliente Java inclut des classes utilitaires pour améliorer la facilité d'utilisation de l'API. Pour en savoir plus, consultez les guides suivants :
- FieldMasks : assistants pour créer et calculer des masques de champ de mise à jour.
- ResourceNames : utilitaires pour mettre en forme les chaînes de nom de ressource d'entité.
- Opérations de longue durée : assistants pour surveiller et gérer les opérations d'API asynchrones.
Ajustez votre application
Consultez le guide d'utilisation avancée pour obtenir des recommandations sur la façon d'ajuster les délais d'attente, les paramètres de nouvelle tentative , la latence de démarrage et la gestion des dépendances de votre application.