Configuration

La bibliothèque cliente de l'API Google Ads fournit plusieurs paramètres de configuration que vous pouvez utiliser pour personnaliser le comportement de la bibliothèque.

Configurer la bibliothèque au moment de l'exécution

La méthode privilégiée pour configurer la bibliothèque cliente consiste à initialiser un objet GoogleAdsConfig au moment de l'exécution:

GoogleAdsConfig config = new GoogleAdsConfig()
{
    DeveloperToken = "******",
    OAuth2Mode = OAuth2Flow.APPLICATION,
    OAuth2ClientId = "******.apps.googleusercontent.com",
    OAuth2ClientSecret = "******",
    OAuth2RefreshToken = "******"
};

GoogleAdsClient client = new GoogleAdsClient(config);

Autres options de configuration

Nous fournissons également des options supplémentaires pour configurer la bibliothèque cliente. Pour les activer, ajoutez une référence NuGet au package Google.Ads.GoogleAds.Extensions dans votre projet.

Si vous utilisez l'une de ces options, les paramètres de configuration ne sont pas détectés automatiquement. Vous devez les charger explicitement, comme indiqué ci-dessous.

Configurer à l'aide d'App.config

Tous les paramètres spécifiques à Google Ads API sont stockés dans le nœud GoogleAdsApi du fichier App.config. Une configuration App.config typique se présente comme suit:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <configSections>
    <section name="GoogleAdsApi" type="System.Configuration.DictionarySectionHandler" />
  </configSections>
  <GoogleAdsApi>
    <!-- Set the service timeout in milliseconds. -->
    <add key="Timeout" value="2000" />

    <!-- Proxy settings for library. -->
    <add key="ProxyServer" value="http://localhost:8888"/>
    <add key="ProxyUser" value=""/>
    <add key="ProxyPassword" value=""/>
    <add key="ProxyDomain" value=""/>

    <!-- API-specific settings -->
    <add key="DeveloperToken" value="******"/>

    <!-- OAuth2 settings -->
    <add key = "OAuth2Mode" value="APPLICATION"/>
    <add key = "OAuth2ClientId" value = "******.apps.googleusercontent.com" />
    <add key = "OAuth2ClientSecret" value = "******" />
    <add key = "OAuth2RefreshToken" value = "******" />
  </GoogleAdsApi>
  <startup>
    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5.2" />
  </startup>
</configuration>

Pour charger les paramètres de configuration à partir d'un fichier App.config, appelez la méthode LoadFromDefaultAppConfigSection sur un objet GoogleAdsConfig:

GoogleAdsConfig config = new GoogleAdsConfig();
config.LoadFromDefaultAppConfigSection();
GoogleAdsClient client = new GoogleAdsClient(config);

Spécifier un fichier App.config distinct

Si vous ne souhaitez pas encombrer votre App.config, vous pouvez déplacer la configuration spécifique à la bibliothèque dans son propre fichier de configuration à l'aide de la propriété configSource.

Étape 1: Spécifiez une source de configuration dans App.config

Modifiez votre App.config pour qu'il se présente comme suit:

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <configSections>
    <section name="GoogleAdsApi" type="System.Configuration.DictionarySectionHandler"/>
  </configSections>
  <GoogleAdsApi configSource="GoogleAdsApi.config"/>
...
</configuration>

Étape 2: Spécifiez le contenu de votre fichier de configuration

Créez maintenant un autre fichier de configuration avec le nom que vous avez spécifié sur configSource, puis déplacez le nœud de configuration de votre App.config vers ce fichier:

<?xml version="1.0" encoding="utf-8" ?>
<GoogleAdsApi>
  ... More settings.
</GoogleAdsApi>

Étape 3: Corrigez les règles de compilation dans votre fichier csproj

Enfin, incluez le nouveau fichier de configuration dans votre projet. Définissez les propriétés de ce fichier sur Always copy to output folder (Toujours copier dans le dossier de sortie).

Créez et exécutez maintenant votre projet. Votre application commencera à récupérer les valeurs du nouveau fichier de configuration.

Configuration à l'aide d'un fichier JSON personnalisé

Vous pouvez utiliser une instance IConfigurationRoot pour configurer la bibliothèque cliente.

Créer un fichier JSON

Créez un fichier JSON nommé GoogleAdsApi.json dont la structure est semblable à celle du fichier App.config.

{
    "Timeout": "2000",

    "ProxyServer": "http://localhost:8888",
    "ProxyUser": "",
    "ProxyPassword": "",
    "ProxyDomain": "",

    "DeveloperToken": "******",

    "OAuth2Mode": "APPLICATION",
    "OAuth2ClientId": "******.apps.googleusercontent.com",
    "OAuth2ClientSecret": "******",
    "OAuth2RefreshToken": "******",
}

Charger la configuration

Ensuite, chargez le fichier JSON dans un IConfigurationRoot.

ConfigurationBuilder builder = new ConfigurationBuilder()
    .SetBasePath(Directory.GetCurrentDirectory())
    .AddJsonFile("GoogleAdsApi.json");
IConfigurationRoot configRoot = builder.Build();

GoogleAdsConfig config = new GoogleAdsConfig();
config.LoadFromConfigurationRoot(configRoot);
GoogleAdsClient client = new GoogleAdsClient(config);

Configuration à l'aide de settings.json

Le processus ici est semblable à celui d'utilisation d'un fichier JSON personnalisé, à l'exception que les clés doivent se trouver dans une section nommée GoogleAdsApi:

{
    "GoogleAdsApi":
    {
        "DeveloperToken": "******",
        "OAuth2Mode": "APPLICATION",
        "OAuth2ClientId": "******.apps.googleusercontent.com",
        "OAuth2ClientSecret": "******",
        "OAuth2RefreshToken": "******",
        ...
    }
    // More settings...
}

Vous pouvez ensuite utiliser l'instance IConfiguration sur votre page:

IConfigurationSection section = Configuration.GetSection("GoogleAdsApi");
GoogleAdsConfig config = new GoogleAdsConfig();
config.LoadFromConfigurationSection(section);
GoogleAdsClient client = new GoogleAdsClient(config);

Configuration à l'aide de variables d'environnement

Vous pouvez également initialiser GoogleAdsClient à l'aide de variables d'environnement:

GoogleAdsConfig config = new GoogleAdsConfig();
config.LoadFromEnvironmentVariables();
GoogleAdsClient client = new GoogleAdsClient(config);

Consultez la liste complète des variables d'environnement compatibles.

Champs de configuration

Vous trouverez ci-dessous la liste des paramètres compatibles avec la bibliothèque Google Ads .NET.

Paramètres de connectivité

  • Timeout: utilisez cette clé pour définir le délai avant expiration du service en millisecondes. La valeur par défaut est définie en fonction du paramètre method_config/timeout dans googleads_grpc_service_config.json. Définissez une valeur inférieure si vous devez appliquer une limite plus courte à la durée maximale d'un appel d'API. Vous pouvez définir le délai avant expiration sur deux heures ou plus, mais l'API peut toujours expirer les requêtes extrêmement longues et renvoyer une erreur DEADLINE_EXCEEDED.
  • ProxyServer: définissez cette valeur sur l'URL du serveur proxy HTTP si vous utilisez un proxy pour vous connecter à Internet.
  • ProxyUser: définissez-le sur le nom d'utilisateur dont vous avez besoin pour vous authentifier auprès du serveur proxy. Laissez ce champ vide si un nom d'utilisateur n'est pas requis.
  • ProxyPassword: définissez cette valeur sur le mot de passe de ProxyUser si vous définissez une valeur pour ProxyUser.
  • ProxyDomain: définissez-le sur le domaine pour ProxyUser si votre serveur proxy en exige un.
  • MaxReceiveMessageLengthInBytes: utilisez ce paramètre pour augmenter la taille maximale de la réponse de l'API que la bibliothèque cliente peut gérer. La valeur par défaut est de 64 Mo.
  • MaxMetadataSizeInBytes: utilisez ce paramètre pour augmenter la taille maximale de la réponse d'erreur de l'API que la bibliothèque cliente peut gérer. La valeur par défaut est de 16 Mo.

Ajustez les paramètres MaxReceiveMessageLengthInBytes et MaxMetadataSizeInBytes pour corriger certaines erreurs ResourceExhausted. Ces paramètres corrigent les erreurs de format Status(StatusCode="ResourceExhausted",Detail="Received message larger than max (423184132 versus 67108864)".

Dans cet exemple, l'erreur est due à la taille du message (423184132 bytes) qui est supérieure à celle que la bibliothèque peut gérer (67108864 bytes). Augmentez MaxReceiveMessageLengthInBytes à 500000000 pour éviter cette erreur.

Notez que l'erreur indique également que votre code a géré un objet Response considérablement volumineux (tel qu'un SearchGoogleAdsResponse volumineux). Cela peut avoir des conséquences sur les performances de votre code en raison de la pile d'objets volumineux de .NET. Si cela devient un problème de performances, vous devrez peut-être trouver un moyen de réorganiser vos appels d'API ou de repenser certaines parties de votre application.

Paramètres OAuth2

Lorsque vous utilisez OAuth2 pour autoriser vos appels auprès des serveurs de l'API Google Ads, vous devez définir les clés de configuration suivantes:

  • Définissez AuthorizationMethod sur OAuth2.
  • OAuth2Mode: définissez cette valeur sur APPLICATION ou SERVICE_ACCOUNT.
  • OAuth2ClientId: définissez cette valeur sur votre ID client OAuth2.
  • OAuth2ClientSecret: définissez cette valeur sur votre code secret client OAuth2.
  • OAuth2Scope: définissez cette valeur sur différentes habilitations si vous souhaitez autoriser des jetons OAuth2 pour plusieurs API. Ce paramètre est facultatif.

Si vous utilisez OAuth2Mode == APPLICATION, vous devez définir les clés de configuration supplémentaires suivantes.

  • OAuth2RefreshToken: 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.
  • OAuth2RedirectUri: définissez cette valeur sur l'URL de redirection OAuth2. Ce paramètre est facultatif.

Pour en savoir plus, consultez les guides suivants:

Si vous utilisez OAuth2Mode == SERVICE_ACCOUNT, vous devez définir les clés de configuration supplémentaires suivantes.

  • OAuth2PrnEmail: définissez cette valeur sur l'adresse e-mail du compte que vous usurpez.
  • OAuth2SecretsJsonPath: définissez cette valeur sur le chemin d'accès au fichier de configuration JSON OAuth2.

Pour en savoir plus, consultez le guide Flux de compte de service OAuth.

Paramètres de transport

Paramètres de l'API Google Ads

Les paramètres suivants sont spécifiques à l'API Google Ads.

  • DeveloperToken: définissez cette valeur sur votre jeton de développeur.
  • LoginCustomerId: ID client autorisé à utiliser dans la requête, sans tirets (-).
  • LinkedCustomerId: cet en-tête n'est requis que pour les méthodes qui mettent à jour les ressources d'une entité lorsqu'elles sont autorisées via des comptes associés dans l'interface utilisateur Google Ads (ressource AccountLink dans l'API Google Ads). Définissez cette valeur sur l'ID client du fournisseur de données qui met à jour les ressources de l'ID client spécifié. Il doit être défini sans tirets (-). En savoir plus sur les comptes associés