Anfragen, Antworten und Zusammenfassungsnachrichten, die an die Google Ads API gesendet werden, können mit Ihrem eigenen benutzerdefinierten Logger oder dem Standardlogger in der Clientbibliothek für Perl protokolliert werden.
Protokollebenen
In der Bibliothek werden verschiedene Arten von Ereignissen auf verschiedenen Protokollebenen protokolliert. Bei einer erfolgreichen API-Antwort wird die Zusammenfassung unter INFO und die vollständige Anfrage und Antwort unter DEBUG protokolliert. Bei einer Anfrage, die zu einem API-Fehler führt, wird die Zusammenfassungsnachricht unter WARN und die vollständige Anfrage und Antwort unter INFO protokolliert.
| Logtyp | Logname | Erfolgsniveau | Fehlerstufe |
|---|---|---|---|
| ZUSAMMENFASSUNG | Google.Ads.GoogleAds.Summary | INFO | WARN |
| DETAILS | Google.Ads.GoogleAds.Detail | FEHLER BEHEBEN | INFO |
Bei teilweisen Fehlern werden die Details zum teilweisen Fehler im DETAIL-Logger unter DEBUG protokolliert.
Konfiguration
Die Clientbibliothek verwendet eine benutzerdefinierte Klasse für alle Protokollierungszwecke, die über das Modul GoogleAdsLogger verfügbar gemacht wird. Diese Klasse bietet eine Standardkonfiguration, bei der sowohl Zusammenfassungs- als auch Detail-Logger in Dateien im Ordner logs unter Ihrem HOME-Verzeichnis schreiben.
Log4perl-Konfiguration anpassen
Sie können die Standardkonfiguration überschreiben, indem Sie eine benutzerdefinierte log4perl.conf-Datei in Ihrem HOME-Verzeichnis bereitstellen oder Log::Log4perl direkt in Ihrer Anwendung initialisieren, bevor Sie API-Aufrufe ausführen.
Logs aktivieren oder deaktivieren
Das Logging kann programmatisch mit den folgenden Hilfsmethoden aktiviert oder deaktiviert werden:
Aktivieren Sie das Logging für beide Logger (übergeben Sie
1, um das Level aufDEBUGfestzulegen, damit vollständige Anfrage- und Antwortnutzlasten für erfolgreiche Aufrufe protokolliert werden):use Google::Ads::GoogleAds::Logging::GoogleAdsLogger; Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging(1);So deaktivieren Sie das gesamte Logging:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_all_logging();Zusammenfassungs-Logging deaktivieren:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();Detailliertes Logging deaktivieren:
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
Sie können die Methoden der Klasse GoogleAdsLogger direkt verwenden, um noch mehr Kontrolle darüber zu haben, wie Anfragen protokolliert werden.