Logging

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

Protokollebenen

Die Bibliothek protokolliert verschiedene Ereignistypen auf verschiedenen Logebenen. Bei einer erfolgreichen API-Antwort wird die Zusammenfassung unter INFO protokolliert und die vollständige Anfrage und die Antworten unter DEBUG. Bei einer Anfrage, die zu einem API-Fehler geführt hat, wird die Zusammenfassungsmeldung unter WARN und die vollständige Anfrage und Antwort unter INFO protokolliert.

Logtyp Logname Erfolgsniveau Fehlerebene
ZUSAMMENFASSUNG Google.Ads.GoogleAds.Summary INFO WARN
DETAILS Google.Ads.GoogleAds.Detail FEHLER BEHEBEN INFO

Bei teilweisen Fehlern werden die Details zum Teilfehler unter DEBUG protokolliert.

Konfiguration

Die Clientbibliothek verwendet für alle Logging-Zwecke eine benutzerdefinierte Klasse und wird über das Modul GoogleAdsLogger bereitgestellt. Diese Klasse bietet eine Standardkonfiguration, bei der sowohl Zusammenfassungs- als auch Detailprotokolle in relativen Dateien im Ordner logs im Verzeichnis HOME protokolliert werden. Die Standardkonfiguration kann jedoch überschrieben werden, indem Sie im Verzeichnis HOME die Datei log4perl.conf angeben.

Sie haben folgende Möglichkeiten, die Protokollierung zu aktivieren oder zu deaktivieren:

  • Aktiviert das Logging für beide Logging-Tools.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();
    
  • Deaktiviert das Zusammenfassungs-Logging.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
    
  • Deaktiviert die Detailprotokollierung.

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

Sie können die Methoden der Klasse GoogleAdsLogger direkt verwenden, um die Protokollierung von Anfragen noch genauer zu steuern.