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 esempioSTDERR
.logger
: specifica il tuo logger personalizzato. Se specifichi questa opzione, verranno sostituiti entrambilog_level
elog_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
: comelog_level
sopra.GOOGLE_ADS_RUBY_HTTP_PROXY
: specifica un proxy HTTP.