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 pour Perl.

Niveaux de journalisation

La bibliothèque consigne différents types d'événements à différents niveaux de journalisation. En cas de réussite de la réponse de l'API, le résumé est enregistré à l'adresse INFO, tandis que la requête complète et les réponses sont consignées à l'adresse DEBUG. Pour une requête ayant entraîné une erreur d'API, le message récapitulatif est consigné à l'adresse WARN, tandis que la requête complète et la réponse 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 de l'échec partiel sont consignés à DEBUG.

Configuration

La bibliothèque cliente utilise une classe personnalisée à toutes les fins 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 enregistreront dans les fichiers relatifs du dossier logs de votre répertoire HOME. Vous pouvez toutefois remplacer la configuration par défaut en fournissant un fichier log4perl.conf dans le répertoire HOME.

Vous pouvez activer/désactiver Logging à 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 mieux contrôler la façon dont les requêtes sont consignées.