Les requêtes, les réponses et les messages récapitulatifs envoyés à l'API Google Ads peuvent être enregistrés avec votre propre enregistreur personnalisé ou l'enregistreur par défaut de la bibliothèque cliente pour Perl.
Niveaux de journalisation
La bibliothèque consigne 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 consigné dans INFO, et la requête et la réponse complètes sont consignées dans DEBUG. Lorsqu'une requête 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 l'enregistreur DETAIL au niveau DEBUG.
Configuration
La bibliothèque cliente utilise une classe personnalisée pour toutes les opérations de journalisation. Elle est exposée via le module GoogleAdsLogger. Cette classe fournit une configuration par défaut dans laquelle les enregistreurs de résumé et de détail écrivent dans des fichiers du dossier logs de votre répertoire HOME.
Personnaliser la configuration de 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 enregistreurs (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ésactivez toute la journalisation :
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_all_logging();Désactivez la journalisation récapitulative :
Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();Désactivez 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.