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

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

Logtyp Logname Erfolgsebene Fehlerstufe
ZUSAMMENFASSUNG Google.Ads.GoogleAds.Summary INFO WARN
DETAILS Google.Ads.GoogleAds.Detail FEHLER BEHEBEN INFO

Bei Teilfehlern 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 Detaillogger in relativen Dateien im Ordner logs im Verzeichnis HOME protokollieren. Die Standardkonfiguration kann jedoch überschrieben werden, indem die Datei log4perl.conf im Verzeichnis HOME bereitgestellt wird.

Logging kann mit den folgenden Methoden aktiviert oder deaktiviert werden:

  • Aktiviert das Logging für beide Logger.

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

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
    
  • Deaktiviert das Detail-Logging.

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

Für noch mehr Kontrolle darüber, wie Anfragen protokolliert werden, können Sie die Methoden der GoogleAdsLogger-Klasse direkt verwenden.