Bibliothèques clientes

Nos bibliothèques clientes fournissent des vues générales et les composants de base des fonctionnalités de l'API Google Ads, ce qui facilite le développement rapide d'applications. Nous vous recommandons de commencer par une version 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-annonces-perl tar.gz, zip Afficher sur GitHub

Versions d'API compatibles

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

Version de l'API Version de la bibliothèque Python Version de la bibliothèque Ruby Version de la bibliothèque PHP Version de la bibliothèque Java Version de la bibliothèque .NET Version de la bibliothèque Perl
V 11 >= 17.0.0 >= 18.0.0 >=15.1.0 >= 19.0.0 >= 12.1.0 >= 12.0.0
V 10 >= 15.0.0 >= 16.0.0 >= 14.0.0 >= 17.0.0 >= 11.0.0 >= 10.0.0
V 9 >= 14.1.0 >= 15.0.0 >= 12.1.0 >= 16.0.0 >= 10.2.0 >= 9.2.0

Configuration

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

Voici les variables d'environnement communes à toutes les bibliothèques clientes et qui peuvent ê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 secret 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 les jetons OAuth2. Ce paramètre est facultatif.
    • Mode du 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 substitué.
  • API Google Ads
    • GOOGLE_ADS_DEVELOPER_TOKEN : définissez-le sur votre jeton de développeur.
    • GOOGLE_ADS_LOGIN_CUSTOMER_ID : numéro 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é lorsqu'il est autorisé via des comptes associés dans l'UI 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 tiret (-). Pour en savoir plus sur les comptes associés, consultez le Centre d'aide.