Logging

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

Protokollebenen

Die Bibliothek protokolliert verschiedene Arten von Ereignissen auf verschiedenen Logebenen. Bei einer erfolgreichen API-Antwort wird die Zusammenfassung unter INFO und die vollständige Anfrage und die vollständigen Antworten unter DEBUG protokolliert. Bei einer Anfrage, die zu einem API-Fehler geführt hat, wird die Zusammenfassungsnachricht 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 Teilfehlern werden die Details zum Teilfehler unter DEBUG protokolliert.

Konfiguration

In der Clientbibliothek wird eine benutzerdefinierte Klasse für alle Protokollierungszwecke verwendet und über das Modul GoogleAdsLogger bereitgestellt. Diese Klasse stellt eine Standardkonfiguration bereit, die sowohl Zusammenfassungs- als auch Detail-Logs in relativen Dateien im Ordner logs im Verzeichnis HOME protokollieren. Die Standardkonfiguration kann jedoch überschrieben werden, indem im Verzeichnis HOME die Datei log4perl.conf bereitgestellt wird.

Logging kann mit den folgenden Methoden aktiviert bzw. deaktiviert werden:

  • Aktiviert das Logging für beide Protokollierungen.

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

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

    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.