La libreria può essere configurata in modo da registrare le interazioni con l'API Google Ads in in vari modi. Potete registrare richieste e risposte dettagliate, e messaggi di riepilogo più concisi. Queste impostazioni sono gestite configurazione della libreria client. Di seguito sono riportati i dettagli i diversi tipi di opzioni di configurazione disponibili.
La libreria utilizza la tecnologia di logging integrata di Python
e registra stderr per impostazione predefinita. Se incluso, l'oggetto logging
definito nella configurazione viene passato direttamente
logging.config.dictConfig
come dict.
Puoi anche configurare il logging in modo programmatico impostando un valore la configurazione prima di inizializzare il client. Puoi recuperare il client logger e configurala con il seguente esempio:
import logging
logging.basicConfig(level=logging.INFO, format='[%(asctime)s - %(levelname)s] %(message).5000s')
logging.getLogger('google.ads.googleads.client').setLevel(logging.INFO)
Tieni presente che il logger del client viene configurato al momento dell'inizializzazione del client. Qualsiasi le modifiche successive alla configurazione del logging verranno ignorate. Per la configurazione di logging nel file YAML in modo programmatico, assicurati di chiama le righe precedenti prima che il client sia inizializzato.
Livelli di log
Il client genera i log a diversi livelli ed è possibile impostare configurazione per visualizzare alcuni o tutti i seguenti dati:
| Livello | Richiesta riuscita | Richiesta non riuscita |
|---|---|---|
DEBUG |
Un log dettagliato con oggetti di richiesta e risposta completi in formato JSON. | Un log dettagliato con oggetti di richiesta ed eccezione completi in formato JSON. |
INFO |
Un breve riepilogo con campi specifici di richiesta e risposta. | Un log dettagliato con oggetti di richiesta ed eccezione completi in formato JSON. |
WARNING |
Nessuno | Un breve riepilogo con informazioni specifiche sulla richiesta, lo stato dell'eccezione e il messaggio. |
Poiché il framework di logging di Python ignora i messaggi di log meno gravi
rispetto al livello configurato, l'impostazione su WARNING significa che vedrai solo
messaggi concisi relativi a richieste non riuscite, ma l'impostazione su DEBUG significa
vedrai tutti i possibili tipi di log nella tabella riportata sopra.
Logging a file
Puoi facilmente reindirizzare i messaggi di log a un file; ad esempio, durante l'esecuzione
Esempio di get_campaigns:
python get_campaigns.py -c $CLIENT_ID 2> example.log
Intercettatori di logging
La libreria client Python utilizza gRPC intercetti per accedere e registrare la richiesta e dettagli della risposta. Puoi impostare il tuo logging personalizzato creando una richiesta gRPC intercettore con logica personalizzata. Vedi la sezione Logging guida per maggiori dettagli e un esempio di intercettatore di logging personalizzato.