Journalisation
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Les requêtes, les réponses et les messages récapitulatifs envoyés à l'API Google Ads peuvent être consignés avec votre propre enregistreur personnalisé ou avec l'enregistreur par défaut de la bibliothèque cliente pour Perl.
Niveaux de journalisation
La bibliothèque enregistre différents types d'événements à différents niveaux de journalisation. En cas de réponse API réussie, le récapitulatif sera consigné au niveau INFO, et la requête et les réponses complètes seront consignées au niveau DEBUG. Pour une requête ayant entraîné une erreur d'API, le message récapitulatif sera consigné au niveau WARN, et la requête et la réponse complètes seront consignées au niveau INFO.
| Type de journal |
Nom du journal |
Niveau de réussite |
Niveau d'échec |
| RÉSUMÉ |
Google.Ads.GoogleAds.Summary |
INFO |
WARN |
| DÉTAILS |
Google.Ads.GoogleAds.Detail |
DEBUG |
INFO |
En cas d'échec partiel, les détails de l'échec partiel sont consignés au niveau DEBUG.
Configuration
La bibliothèque cliente utilise une classe personnalisée à des fins de journalisation et est exposée via le module GoogleAdsLogger. Cette classe fournit une configuration par défaut qui permet aux enregistreurs de journaux récapitulatifs et détaillés d'enregistrer les journaux dans des fichiers relatifs du dossier logs sous votre répertoire HOME.
Toutefois, la configuration par défaut peut être remplacée en fournissant un fichier log4perl.conf dans votre répertoire HOME.
Vous pouvez activer ou désactiver la journalisation à l'aide des méthodes suivantes :
Active la journalisation pour les deux enregistreurs.
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();
Désactive la journalisation du récapitulatif.
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
Désactive la journalisation détaillée.
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();
Vous pouvez utiliser directement les méthodes de la classe GoogleAdsLogger pour contrôler encore plus précisément la façon dont les requêtes sont enregistrées.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/27 (UTC).
[null,null,["Dernière mise à jour le 2025/08/27 (UTC)."],[[["\u003cp\u003eThe Google Ads API client library for Perl allows logging of requests, responses, and summaries using a custom or default logger.\u003c/p\u003e\n"],["\u003cp\u003eLogging levels include \u003ccode\u003eINFO\u003c/code\u003e, \u003ccode\u003eDEBUG\u003c/code\u003e, and \u003ccode\u003eWARN\u003c/code\u003e, used to categorize different event types like successes, failures, and partial failures.\u003c/p\u003e\n"],["\u003cp\u003eThe default logger configuration saves logs to the \u003ccode\u003elogs\u003c/code\u003e folder in your home directory, which can be customized by providing a \u003ccode\u003elog4perl.conf\u003c/code\u003e file.\u003c/p\u003e\n"],["\u003cp\u003eLogging can be controlled through the \u003ccode\u003eGoogleAdsLogger\u003c/code\u003e module, allowing for enabling/disabling logging or more advanced customization.\u003c/p\u003e\n"]]],[],null,["# Logging\n\nRequests, responses, and summary messages made to the Google Ads API can be\nlogged with your own custom logger or the default logger in the client library\nfor Perl.\n\nLog Levels\n----------\n\nThe library will log different types of events to different log levels. On a\nsuccessful API response, the summary will be logged at `INFO`, and the full\nrequest and responses will be logged at `DEBUG`. On a request that resulted in\nan API error, the summary message will be logged at `WARN` and the full request\nand response will be logged at `INFO`.\n\n| Log type | Log name | Success level | Failure level |\n|----------|------------------------------|---------------|---------------|\n| SUMMARY | Google.Ads.GoogleAds.Summary | INFO | WARN |\n| DETAIL | Google.Ads.GoogleAds.Detail | DEBUG | INFO |\n\nFor partial failures, the partial failure details will be logged at `DEBUG`.\n\nConfiguration\n-------------\n\nThe client library uses a custom class for all logging purposes and is exposed\nthrough the [GoogleAdsLogger](https://github.com/googleads/google-ads-perl/blob/HEAD/lib/Google/Ads/GoogleAds/Logging/GoogleAdsLogger.pm)\nmodule. This class provides a default configuration that both summary and detail\nloggers will log to relative files in the `logs` folder under your `HOME` directory.\nBut the default configuration can be overridden by providing a\n[log4perl.conf](https://github.com/googleads/google-ads-perl/blob/HEAD/log4perl.conf)\nfile in your `HOME` directory.\n\nLogging can be enabled/disabled using the following methods:\n\n- Enables logging for both loggers.\n\n Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging();\n\n- Disables the summary logging.\n\n Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();\n\n- Disables the detail logging.\n\n Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_detail_logging();\n\nYou can use the methods of the `GoogleAdsLogger` class directly for even more\ncontrol over how requests are logged."]]
