Journalisation

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 avec l'enregistreur par défaut dans la bibliothèque cliente de Perl.

Niveaux de journalisation

La bibliothèque enregistrera différents types d'événements à différents niveaux de journalisation. Si la réponse de l'API aboutit, le résumé est consigné dans INFO, tandis que la requête et les réponses complètes sont consignées dans DEBUG. Lorsqu'une requête entraîne une erreur d'API, le message récapitulatif est consigné à l'adresse WARN, et la requête et la réponse complètes sont consignées à l'adresse INFO.

Type de journal Nom du journal Niveau de réussite Niveau d'échec
SUMMARY Google.Ads.GoogleAds.Summary INFO WARN
DÉTAILS Google.Ads.GoogleAds.Detail DEBUG INFO

Pour les échecs partiels, les détails sont consignés dans DEBUG.

Configuration

La bibliothèque cliente utilise une classe personnalisée pour toutes les tâches de journalisation et est exposée via le module GoogleAdsLogger. Cette classe fournit une configuration par défaut que les enregistreurs de résumé et de détails consignent dans les 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 le 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 récapitulative.

    Google::Ads::GoogleAds::Logging::GoogleAdsLogger::disable_summary_logging();
    
  • Désactive 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 encore plus de contrôle sur la façon dont les requêtes sont consignées.