Configurazione

La configurazione viene eseguita utilizzando un corso Config. Puoi accedere a questo corso in più in vari modi, ad esempio scrivendo un file di configurazione, specificando valori al momento della creazione o caricare i valori dalle variabili di ambiente.

File di configurazione

Puoi specificare un google_ads_config.rb il file da utilizzare per creare un'istanza del client.

Se non utilizzi argomenti durante la creazione di un'istanza:

client = Google::Ads::GoogleAds::GoogleAdsClient.new

la libreria cercherà nella posizione specificata GOOGLE_ADS_CONFIGURATION_FILE_PATH variabile di ambiente. Se la variabile è non impostato, la libreria cercherà il file nella directory HOME.

In alternativa, puoi specificare un percorso:

client = Google::Ads::GoogleAds::GoogleAdsClient.new("path/to/file.rb")

In questo caso il client cercherà il file in quel percorso.

Il modo più semplice per generare questo file è copiare il file google_ads_config.rb da il repository GitHub e modificarlo in modo che includa il token di aggiornamento, l'ID client e client secret.

Configurazione dinamica

Puoi impostare la configurazione in modo dinamico quando crei un'istanza per la libreria, o anche dopo:

client = Google::Ads::GoogleAds::GoogleAdsClient.new do |config|
  config.client_id = 'INSERT_CLIENT_ID_HERE'
  # ... more configuration
end

Puoi anche modificare la configurazione dopo la creazione dell'istanza:

client.configure do |config|
  config.login_customer_id = 'INSERT_LOGIN_CUSTOMER_ID_HERE'
  # ... more configuration
end

Campi di configurazione

L'oggetto Config supporta i seguenti campi.

Campi generali:

  • refresh_token: il tuo token di aggiornamento OAuth.
  • client_id: il tuo ID client OAuth.
  • client_secret: il tuo client secret OAuth.
  • developer_token: il tuo token sviluppatore per accedere all'API.
  • login_customer_id: vedi le documentazione di login-customer-id.

Campi Logging. Per informazioni dettagliate, consulta la guida al logging.

  • log_level: il numero minimo di messaggi a livello di log che vuoi registrare. Ad esempio: specificando 'DEBUG' ti consentirà di vedere tutti i messaggi di log, mentre 'INFO' escluderà i messaggi DEBUG ma mostrerà tutti gli altri.
  • log_target: dove vuoi accedere, ad esempio STDERR.
  • logger: specifica il tuo logger personalizzato. Se specifichi questa opzione, verranno sostituiti entrambi log_level e log_target.

Variabili di ambiente

Puoi configurare la libreria client utilizzando le variabili di ambiente. Non sono vengono caricati per impostazione predefinita e richiedono una chiamata aggiuntiva dopo aver creato un'istanza per caricare il client. Consulta l'elenco completo delle variabili di ambiente supportata da tutti lingue.

Per caricare le variabili di ambiente in Config, chiama load_environment_config:

client = Google::Ads::GoogleAds::GoogleAdsClient.new
client.load_environment_config

Ogni volta che viene richiamata, lo stato attuale delle variabili di ambiente sovrascriverà tutto ciò che è già presente in Config. Con questo meccanismo di attenzione, puoi ad esempio avere una configurazione predefinita ma eseguire l'override utilizzando le variabili di ambiente, oppure puoi variabili di ambiente.

Oltre alle variabili di ambiente supportate da tutte le librerie, ha due variabili aggiuntive:

  • GOOGLE_ADS_RUBY_LOG_LEVEL: come log_level sopra.
  • GOOGLE_ADS_RUBY_HTTP_PROXY: specifica un proxy HTTP.