La libreria client dell'API Ads offre diverse impostazioni di configurazione che puoi utilizzare per personalizzare il comportamento della libreria.
File di configurazione
Puoi specificare un file googleads.properties
da utilizzare per creare l'istanza del client.
Se non utilizzi argomenti durante la creazione di un'istanza:
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 in quel percorso.
Il modo più semplice per generare questo file è copiare il googleads.properties
dal repository GitHub e modificarlo in modo da includere il tuo ID client, il tuo client secret e il tuo token di aggiornamento.
Configurazione dinamica
Puoi impostare la configurazione in modo dinamico quando crei l'istanza della libreria o anche dopo:
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'istanza:
$api_client->set_login_customer_id("INSERT_LOGIN_CUSTOMER_ID_HERE");
Puoi anche ottenere un oggetto OAuth2ApplicationsHandler da API Client
e modificare l'ID client, il client secret e il token di aggiornamento in fase di runtime:
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 delle impostazioni di configurazione dalle variabili di ambiente durante la creazione di clienti (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:
I campi sono persistenti 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 persistenti nel client API:
developer_token
: il token sviluppatore per accedere all'API.login_customer_id
: consulta la documentazione di login-customer-id.proxy
: l'URL del server proxy utilizzato per la connettività a internet.