La bibliothèque cliente de l'API Ads fournit plusieurs paramètres de configuration que vous pouvez utiliser pour personnaliser son comportement.
Fichier de configuration
Vous pouvez spécifier un fichier 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 dans ce chemin d'accès.
Le moyen le plus simple de générer ce fichier consiste à copier le fichier googleads.properties du dépôt GitHub et à le modifier pour inclure votre ID client, son code secret et son jeton d'actualisation.
Configuration dynamique
Vous pouvez définir la configuration de manière dynamique lors de l'instanciation de la bibliothèque ou 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 objet OAuth2ApplicationsHandler à partir de API Client et modifier l'ID client, le code secret du client et le 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 lors de l'instanciation de clients (consultez la liste exhaustive).
Le module Client fournit la fonction configure_from_environment_variables permettant de 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 persistants dans OAuth2ApplicationsHandler:
client_id: votre ID client OAuth2.client_secret: votre code secret de client OAuth2.refresh_token: votre jeton d'actualisation OAuth2.
Champs persistants dans API Client:
developer_token: votre jeton de développeur pour l'accès à l'API.login_customer_id: consultez la documentation sur l'ID client de connexion.proxy: URL du serveur proxy utilisé pour la connectivité Internet.