Activer Logging

La bibliothèque fournit une journalisation polyvalente pour les interactions avec l'API Google Ads. Vous pouvez capturer :

  • Informations détaillées : requêtes complètes envoyées à l'API et réponses reçues.
  • Résumés concis : une vue d'ensemble des interactions.

Vous pouvez contrôler ces paramètres de journalisation de deux manières :

  • Configuration de la bibliothèque cliente : utilisez les options de configuration spécifiques à la bibliothèque.
  • De manière programmatique avec Python : utilisez le framework logging intégré à Python pour un contrôle plus direct.

La journalisation est configurée automatiquement lorsqu'une instance GoogleAdsClient est initialisée. Cette étape d'initialisation se produit, par exemple, lorsque vous utilisez la méthode load_from_storage. À ce stade, la bibliothèque :

Lorsque cette bibliothèque est utilisée comme package installé, vous devez intégrer sa journalisation à la configuration de journalisation de votre application. Plus précisément, vous devez ajouter un gestionnaire de journaux à la propre instance de journalisation de la bibliothèque avec la méthode addHandler. Ce gestionnaire indique où les messages de journal de la bibliothèque sont dirigés (par exemple, vers la console, un fichier, etc.). Pour ce faire, commencez par récupérer l'instance du journaliseur de la bibliothèque, comme indiqué ci-dessous :

import logging

logger = logging.getLogger('google.ads.googleads.client')

Après avoir récupéré le journaliseur de la bibliothèque, vous pouvez lui indiquer où afficher les messages de journal.

  • Envoi des journaux à la console : pour afficher les messages de journaux sur votre console, ajoutez un gestionnaire de base. Pour rediriger les journaux vers la sortie standard (stdout) :

    Voici comment définir un gestionnaire de base qui indiquera au journaliseur d'imprimer dans stdout :

    import sys

# Assuming 'logger' was retrieved as per previous instructions
logger.addHandler(logging.StreamHandler(sys.stdout))

    Si vous préférez envoyer les journaux vers l'erreur standard (stderr), qui est souvent utilisée pour les messages d'erreur et les avertissements :

    import sys

# Assuming 'logger' was retrieved as per previous instructions
logger.addHandler(logging.StreamHandler(sys.stderr))

  • Configurer d'autres paramètres de journalisation de manière programmatique : une fois que vous avez l'objet enregistreur, vous pouvez également modifier d'autres paramètres de journalisation de manière programmatique à l'aide du module logging intégré de Python. Par exemple, pour définir le niveau de journalisation sur DEBUG (qui affichera des messages plus détaillés) :

    logger.setLevel(logging.DEBUG)

Niveaux de journalisation

Le client génère des journaux à différents niveaux. Vous pouvez configurer votre configuration pour afficher tout ou partie des éléments ci-dessous :

Niveau Demande réussie Échec de la demande
DEBUG Journal détaillé avec des objets de requête et de réponse complets au format JSON. Journal détaillé avec les objets de requête et d'exception complets au format JSON.
INFO Un résumé concis avec des champs de requête et de réponse spécifiques. Journal détaillé avec les objets de requête et d'exception complets au format JSON.
WARNING Aucun Un résumé concis contenant des informations spécifiques sur la requête, l'état de l'exception et le message.

Étant donné que le framework de journalisation Python ignore les messages de journaux moins graves que le niveau configuré, la définition sur WARNING signifie que vous ne verrez que des messages concis liés aux demandes ayant échoué. En revanche, la définition sur DEBUG signifie que vous verrez tous les types de journaux possibles dans le tableau ci-dessus.

Journalisation dans un fichier

Lorsque vous exécutez des scripts exemples tels que get_campaigns.py à partir de votre ligne de commande, tous les messages de journalisation généralement affichés dans la console peuvent être redirigés (ou "transférés") vers un fichier. Il s'agit d'une fonctionnalité du shell de votre système d'exploitation, et non de la bibliothèque Python elle-même. Voici comment procéder :

Pour enregistrer la sortie standard (la plupart des journaux) dans un fichier (en l'écrasant) :

python get_campaigns.py -c $CLIENT_ID > campaign_logs.txt

Pour ajouter la sortie standard à un fichier :

python get_campaigns.py -c $CLIENT_ID >> campaign_logs.txt

Pour enregistrer la sortie standard et l'erreur standard (pour les erreurs/avertissements) dans le même fichier :

python get_campaigns.py -c $CLIENT_ID > all_logs.txt 2>&1

(Ou sur certains shells modernes comme Bash 4+) :

python get_campaigns.py -c $CLIENT_ID &> all_logs.txt

Intercepteurs de journalisation

La bibliothèque cliente Python utilise des intercepteurs gRPC pour accéder aux détails des requêtes et des réponses, et les consigner. Vous pouvez configurer votre propre journalisation personnalisée en créant un intercepteur gRPC avec une logique personnalisée. Pour en savoir plus et obtenir un exemple d'intercepteur de journalisation personnalisé, consultez le guide de journalisation.