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 journaux. En cas de réponse API réussie, le récapitulatif est consigné au niveau INFO, et la requête et la réponse complètes sont consignées au niveau DEBUG. Pour une requête qui génère une erreur d'API, le message récapitulatif est consigné au niveau WARN, et la requête et la réponse complètes sont 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 dans le journal DETAIL à 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 dans laquelle les enregistreurs de journaux récapitulatifs et détaillés écrivent dans des fichiers du dossier logs sous votre répertoire HOME.
Personnaliser la configuration Log4perl
Vous pouvez remplacer la configuration par défaut en fournissant un fichier log4perl.conf personnalisé dans votre répertoire HOME ou en initialisant Log::Log4perl directement dans votre application avant d'effectuer des appels d'API.
Activer ou désactiver les journaux
La journalisation peut être activée ou désactivée de manière programmatique à l'aide des méthodes d'assistance suivantes :
Activez la journalisation pour les deux journaux (transmettez
1pour définir le niveau surDEBUGafin que les charges utiles complètes des requêtes et des réponses soient enregistrées pour les appels réussis) :use Google::Ads::GoogleAds::Logging::GoogleAdsLogger; Google::Ads::GoogleAds::Logging::GoogleAdsLogger::enable_all_logging(1);Désactiver toute la journalisation :
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_all_logging();Désactiver la journalisation des résumés :
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();Désactiver 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.