Die Bibliothek kann so konfiguriert werden, dass Interaktionen mit der Google Ads API in verschiedene Möglichkeiten haben. Sie können detaillierte Anfragen und Antworten protokollieren, wie sowie prägnantere Zusammenfassungen. Diese Einstellungen werden vom Konfiguration der Clientbibliothek. Nachfolgend finden Sie Details zu den verschiedene Arten von Konfigurationsoptionen zur Verfügung.
Die Bibliothek verwendet das integrierte Logging von Python
und Logs standardmäßig auf stderr. Falls angegeben, wird das Objekt logging
die in Ihrer Konfiguration definiert sind,
logging.config.dictConfig
als dict.
Sie können die Protokollierung auch programmatisch konfigurieren, indem Sie eine Protokollierung festlegen. Konfiguration bevor der Client initialisiert wird. Sie können den Client logger-Instanz an und konfigurieren Sie sie mit dem folgenden Beispiel:
import logging
logging.basicConfig(level=logging.INFO, format='[%(asctime)s - %(levelname)s] %(message).5000s')
logging.getLogger('google.ads.googleads.client').setLevel(logging.INFO)
Beachten Sie, dass die Client-Protokollierung konfiguriert wird, wenn der Client initialisiert wird. Beliebig werden nachfolgende Änderungen an der Logging-Konfiguration ignoriert. Um die Logging-Konfiguration in der YAML-Datei programmatisch überschreiben rufen Sie die obigen Zeilen auf, bevor der Client initialisiert wird.
Protokollebenen
Der Client generiert Protokolle auf verschiedenen Ebenen und Sie können Konfiguration, um einige oder alle der folgenden Elemente zu sehen:
| Level | Anfrage erfolgreich | Fehlgeschlagene Anfrage |
|---|---|---|
DEBUG |
Ein detailliertes Log mit vollständigen Anfrage- und Antwortobjekten im JSON-Format. | Ein detailliertes Log mit vollständiger Anfrage und Ausnahmeobjekten im JSON-Format. |
INFO |
Eine kurze Zusammenfassung mit spezifischen Anfrage- und Antwortfeldern. | Ein detailliertes Log mit vollständiger Anfrage und Ausnahmeobjekten im JSON-Format. |
WARNING |
Keine | Eine kurze Zusammenfassung mit spezifischen Anfrageinformationen, dem Ausnahmestatus und der Meldung. |
Da das Python-Logging-Framework weniger schwerwiegende Lognachrichten ignoriert,
als die konfigurierte Ebene ist. Wenn Sie WARNING auswählen, sehen Sie nur
prägnante Nachrichten im Zusammenhang mit fehlgeschlagenen Anfragen. Wenn Sie jedoch DEBUG festlegen,
sehen Sie in der Tabelle oben alle
möglichen Log-Typen.
Wird in Datei protokolliert
Sie können Lognachrichten ganz einfach an eine Datei weiterleiten. zum Beispiel beim Ausführen des
Beispiel für get_campaigns:
python get_campaigns.py -c $CLIENT_ID 2> example.log
Logging-Abfangende
Die Python-Clientbibliothek verwendet gRPC interestors für den Zugriff auf die Anfrage und die Protokollierung der Anfrage und Antwortdetails. Sie können Ihr eigenes benutzerdefiniertes Logging einrichten, indem Sie einen gRPC-Client erstellen. Interceptor mit benutzerdefinierter Logik. Weitere Informationen finden Sie im Abschnitt zur Protokollierung Leitfaden .