Logging

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

Protokollebenen

Die Bibliothek protokolliert verschiedene Ereignistypen auf verschiedenen Protokollebenen. Bei einer erfolgreichen API-Antwort wird die Zusammenfassung auf der Ebene INFO protokolliert und die vollständige Anfrage und Antwort auf der Ebene DEBUG. Bei einer Anfrage, die zu einem API-Fehler führt, wird die Zusammenfassungsnachricht auf der Ebene WARN protokolliert und die vollständige Anfrage und Antwort auf der Ebene INFO.

Bei teilweisen Fehlern werden die Details zu den teilweisen Fehlern auf der Ebene DEBUG im Logger DETAIL protokolliert.

Konfiguration

Die Clientbibliothek verwendet für alle Protokollierungszwecke eine benutzerdefinierte Klasse, die über das GoogleAdsLogger Modul verfügbar gemacht wird. Diese Klasse bietet eine Standardkonfiguration, bei der sowohl Zusammenfassungs- als auch Detaillogger 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

Die Protokollierung kann programmatisch mit den folgenden Hilfsmethoden aktiviert oder deaktiviert werden:

• Protokollierung für beide Logger aktivieren (übergeben Sie 1, um die Ebene auf DEBUG zu setzen, damit die vollständigen Nutzlasten von Anfragen und Antworten für erfolgreiche Aufrufe protokolliert werden):

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

• Gesamte Protokollierung deaktivieren:

  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_all_logging();
  

• Zusammenfassungsprotokollierung deaktivieren:

  Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
  

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