Configurazione

La libreria client dell'API Google Ads fornisce diverse impostazioni di configurazione che puoi utilizzare per personalizzare il comportamento della raccolta.

File di configurazione

Puoi specificare un googleads.properties il file da utilizzare per creare un'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 file googleads.properties da il repository GitHub e modificarlo in modo che includa l'ID client, il client secret token di aggiornamento.

Configurazione dinamica

Puoi impostare la configurazione in modo dinamico quando crei un'istanza della libreria oppure 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 la creazione dell'istanza:

$api_client->set_login_customer_id("INSERT_LOGIN_CUSTOMER_ID_HERE");

Puoi anche ottenere un OAuth2ApplicationsHandler oggetto da API Client e modificare l'ID client, il client secret e di aggiornamento del token 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 definire alcune impostazioni di configurazione dalle variabili di ambiente quando creare un'istanza per i clienti (consulta le istruzioni elenco).

Il modulo Client fornisce i 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 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 mantenuti nel Client API:

  • developer_token: il tuo token sviluppatore per accedere all'API.
  • login_customer_id: vedi le documentazione di login-customer-id.
  • proxy: l'URL del server proxy utilizzato per la connettività a internet.