Les requêtes, les réponses et les messages récapitulatifs adressés à l'API Google Ads peuvent être consignés à l'aide de votre propre enregistreur personnalisé ou de 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 de l'API réussie, le résumé est enregistré au niveau INFO, et la requête et la réponse complètes sont enregistrées au niveau DEBUG. En cas de requête entraînant une erreur d'API, le message récapitulatif est enregistré au niveau WARN, et la requête et la réponse complètes sont enregistré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 enregistrés dans l'enregistreur DETAIL au niveau DEBUG.
Configuration
La bibliothèque cliente utilise une classe personnalisée à des fins de journalisation et est exposée
via le GoogleAdsLogger module. Cette classe fournit une configuration par défaut dans laquelle les enregistreurs de résumé et de détails écrivent dans des fichiers du dossier logs de votre répertoire HOME.
Personnaliser la configuration Log4perl
Vous pouvez remplacer la configuration par défaut en fournissant un fichier personnalisé
log4perl.conf 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 par programmation à l'aide des méthodes d'assistance suivantes :
Activer la journalisation pour les deux enregistreurs (transmettez
1pour définir le niveau surDEBUG, afin 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 des détails :
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 manière dont les requêtes sont enregistrées.