Logging

Anfragen, Antworten und Zusammenfassungen, die an die Google Ads API gesendet werden, können mit Ihrem eigenen benutzerdefinierten Logger oder dem Standard-Logger in der Clientbibliothek für Perl protokolliert werden.

Logebenen

Die Bibliothek protokolliert verschiedene Arten von Ereignissen auf unterschiedlichen Logebenen. 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 Zusammenfassungsmeldung unter WARN und die vollständige Anfrage und Antwort unter INFO protokolliert.

Logtyp	Logname	Erfolgsstufe	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 Logging-Zwecke und wird über das Modul GoogleAdsLogger bereitgestellt. Diese Klasse bietet eine Standardkonfiguration, bei der sowohl Zusammenfassungs- als auch Detail-Logger in Dateien im Ordner logs in 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 mit den folgenden Hilfsmethoden programmatisch aktiviert oder deaktiviert werden:

• Aktivieren Sie das Logging für beide Logger (übergeben Sie 1, um die Ebene auf DEBUG festzulegen, damit die vollständigen Anfrage- und Antwortnutzlasten für erfolgreiche Aufrufe protokolliert werden):

  use Google::Ads::GoogleAds::Logging::GoogleAdsLogger;
  
  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging(1);
  

• 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.