Bibliothèques clientes

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Nos bibliothèques clientes fournissent des vues générales et des composants de base des fonctionnalités de l'API Google Ads, ce qui facilite le développement rapide des applications. Nous vous recommandons de commencer par une instance si vous débutez avec l'API.

Bibliothèque cliente Source Distribution Exemples de code
Java google-ads-java Maven, tar.gz Afficher sur GitHub
.NET google-ads-dotnet tar.gz, zip Afficher sur GitHub
PHP google-ads-php tar.gz Afficher sur GitHub
Python google-ads-python. tar.gz, zip Afficher sur GitHub
Ruby google-ads-ruby gem, tar.gz, zip Afficher sur GitHub
Perl google-ads-perl tar.gz, zip Afficher sur GitHub

Versions d'API compatibles

Le tableau ci-dessous répertorie les versions de bibliothèque spécifiques compatibles avec chaque version d'API disponible.

Java

API et versions minimales/maximales de Java compatibles
v 12 Min: 22.0.0
Max: -
v11 Min: 19.0.0
Max: -
v 10 Min: 17.0.0
Max: -

C#

API et versions .NET min/max compatibles
v 12 Min: 14.2.0
Max: -
v11 Min: 12.1.0
Max: -
v 10 Min: 11.0.0
Max: -

PHP

API et versions PHP minimales/maximales compatibles
v 12 Min: 17.1.0
Max: -
v11 Min: 15.1.0
Max: -
v 10 Min: 14.0.0
Max: -

Python

API et versions Python minimale/maximale compatibles
v 12 Min: 19.0.0
Max: -
v11 Min: 17.0.0
Max: -
v 10 Min: 15.0.0
Max: -

Ruby

API et versions minimales/maximales de Ruby compatibles
v 12 Min: 20.0.0
Max: -
v11 Min: 18.0.0
Max: -
v 10 Min: 16.0.0
Max: -

Perl

API et versions minimales/maximales compatibles
v 12 Min: 14.0.0
Max: -
v11 Min: 12.0.0
Max: -
v 10 Min: 10.0.0
Max: -

Configuration

Chaque bibliothèque cliente de l'API Ads fournit différents paramètres de configuration et méthodes de chargement que vous pouvez utiliser pour personnaliser son comportement.

Voici les variables d'environnement communes à toutes les bibliothèques clientes et pouvant être chargées pour définir les paramètres de configuration:

  • Bibliothèque cliente
    • GOOGLE_ADS_CONFIGURATION_FILE_PATH : chemin d'accès au fichier de configuration.
  • OAuth2
    • Mode Application
      • GOOGLE_ADS_CLIENT_ID : définissez cette valeur sur votre ID client OAuth2.
      • GOOGLE_ADS_CLIENT_SECRET : définissez cette valeur sur votre code secret du client OAuth2.
      • GOOGLE_ADS_REFRESH_TOKEN : définissez cette valeur sur un jeton d'actualisation OAuth2 prégénéré si vous souhaitez réutiliser des jetons OAuth2. Ce paramètre est facultatif.
    • Mode Compte de service
      • GOOGLE_ADS_JSON_KEY_FILE_PATH : définissez cette valeur sur le chemin du fichier de configuration JSON OAuth2.
      • GOOGLE_ADS_IMPERSONATED_EMAIL : définissez cette valeur sur l'adresse e-mail du compte auquel vous êtes connecté.
  • API Google Ads
    • GOOGLE_ADS_DEVELOPER_TOKEN : définissez ce paramètre sur votre jeton de développeur.
    • GOOGLE_ADS_LOGIN_CUSTOMER_ID : numéro client du client autorisé à utiliser dans la requête, sans traits d'union (-).
    • GOOGLE_ADS_LINKED_CUSTOMER_ID : cet en-tête n'est requis que pour les méthodes qui mettent à jour les ressources d'une entité lorsque l'autorisation est accordée via les comptes associés dans l'interface utilisateur Google Ads (ressource AccountLink dans l'API Google Ads). Définissez cette valeur sur le numéro client du fournisseur de données qui met à jour les ressources du numéro client spécifié. Il ne doit pas comporter de trait d'union (-). Pour en savoir plus sur les comptes associés, consultez le Centre d'aide.