La libreria client dell'API Ads fornisce diverse impostazioni di configurazione che puoi utilizzare per personalizzare il comportamento della libreria.
File di configurazione
Puoi specificare un
googleads.properties
file da utilizzare durante l'inizializzazione del client.
Se non utilizzi argomenti durante l'inizializzazione:
my $api_client = Google::Ads::GoogleAds::Client->new();
la libreria cercherà il file nella directory HOME.
In alternativa, puoi specificare un percorso:
my $properties_file = "/path/to/googleads.properties";
my $api_client = Google::Ads::GoogleAds::Client->new({
properties_file => $properties_file
});
in questo caso il client cercherà il file nel percorso specificato.
Il modo più semplice per generare questo file è copiare il file googleads.properties dal
repository GitHub e modificarlo in modo da includere l'ID cliente, il secret client e
il token di aggiornamento.
Configurazione dinamica
Puoi configurare la configurazione in modo dinamico durante l'inizializzazione della libreria o anche in un secondo momento:
my $api_client = Google::Ads::GoogleAds::Client->new({
developer_token => "INSERT_DEVELOPER_TOKEN_HERE",
login_customer_id => "INSERT_LOGIN_CUSTOMER_ID_HERE"
});
Puoi anche modificare la configurazione dopo l'instanziazione:
$api_client->set_login_customer_id("INSERT_LOGIN_CUSTOMER_ID_HERE");
Puoi anche recuperare un oggetto OAuth2ApplicationsHandler
da API Client e modificare l'ID client, il segreto client e il
token di aggiornamento in fase di esecuzione:
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");
Variabili di ambiente di configurazione
Puoi impostare alcune impostazioni di configurazione dalle variabili di ambiente quando li lighi ai client (consulta l'elenco completo).
Il modulo Client fornisce la funzione configure_from_environment_variables
per caricare i valori dalle variabili di ambiente:
# 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();
Campi di configurazione
Le proprietà di configurazione supportano i seguenti campi:
Campi mantenuti in OAuth2ApplicationsHandler:
client_id: il tuo ID client OAuth2.client_secret: il tuo client secret OAuth2.refresh_token: il tuo token di aggiornamento OAuth2.
Campi mantenuti nel client API:
developer_token: il tuo token sviluppatore per accedere all'API.login_customer_id: consulta la documentazione relativa a login-customer-id.proxy: l'URL del server proxy utilizzato per la connettività a internet.