Configuration

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

Fichier de configuration

Vous pouvez spécifier un googleads.properties à utiliser lors de l'instanciation du client.

Si vous n'utilisez aucun argument lors de l'instanciation:

my $api_client = Google::Ads::GoogleAds::Client->new();

la bibliothèque recherchera le fichier dans votre répertoire HOME.

Vous pouvez également spécifier un chemin d'accès:

my $properties_file = "/path/to/googleads.properties";

my $api_client = Google::Ads::GoogleAds::Client->new({
  properties_file => $properties_file
});

auquel cas le client recherchera le fichier à ce chemin de fichier.

Le moyen le plus simple de générer ce fichier consiste à copier googleads.properties à partir de dans le dépôt GitHub et modifiez-le pour inclure votre ID client, le code secret du client d'actualisation.

Configuration dynamique

Vous pouvez définir la configuration de manière dynamique lorsque vous instanciez la bibliothèque. même après:

my $api_client = Google::Ads::GoogleAds::Client->new({
  developer_token   => "INSERT_DEVELOPER_TOKEN_HERE",
  login_customer_id => "INSERT_LOGIN_CUSTOMER_ID_HERE"
});

Vous pouvez même modifier la configuration après l'instanciation:

$api_client->set_login_customer_id("INSERT_LOGIN_CUSTOMER_ID_HERE");

Vous pouvez également obtenir un gestionnaire OAuth2ApplicationsHandler à partir de API Client, et modifiez l'identifiant du client, son code secret jeton d'actualisation lors de l'exécution:

my $oauth2_applications_handler = $api_client->get_oauth2_applications_handler();
$oauth2_applications_handler->set_client_id("INSERT_CLIENT_ID");
$oauth2_applications_handler->set_client_secret("INSERT_CLIENT_SECRET");
$oauth2_applications_handler->set_refresh_token("INSERT_REFRESH_TOKEN");

Variables d'environnement de configuration

Vous pouvez définir certains paramètres de configuration à partir de variables d'environnement lorsque d'instancier des clients (voir la liste liste).

Le module Client fournit le configure_from_environment_variables pour charger des valeurs à partir de variables d'environnement:

# Get the Google Ads Client. By default, any credentials will be read from
# ~/googleads.properties, or, if set, from the file specified in the
# GOOGLE_ADS_CONFIGURATION_FILE_PATH environment variable.
my $api_client = Google::Ads::GoogleAds::Client->new();

# Load the configuration from any set environment variables.
$api_client->configure_from_environment_variables();

Champs de configuration

Les propriétés de configuration acceptent les champs suivants:

Champs conservés dans OAuth2ApplicationsHandler:

  • client_id: votre ID client OAuth2.
  • client_secret: votre code secret de client OAuth2.
  • refresh_token: votre jeton d'actualisation OAuth2.

Champs conservés dans le client API:

  • developer_token: votre jeton de développeur pour accéder à l'API.
  • login_customer_id: consultez les documentation sur login-customer-id.
  • proxy: URL du serveur proxy utilisée pour la connectivité Internet.