La bibliothèque peut être configurée de différentes manières pour enregistrer les interactions avec l'API Google Ads. Vous pouvez consigner des requêtes et des réponses détaillées, ainsi que des messages récapitulatifs plus concis. Ces paramètres sont gérés par la configuration de la bibliothèque cliente. Vous trouverez ci-dessous des informations détaillées sur les différents types d'options de configuration disponibles.
La bibliothèque utilise le framework de journalisation intégré de Python et consigne stderr
par défaut. S'il est inclus, l'objet logging
défini dans votre configuration est directement transmis à logging.config.dictConfig
en tant que dict
.
Vous pouvez également configurer la journalisation de manière automatisée en définissant une configuration de journalisation avant d'initialiser le client. Vous pouvez récupérer l'instance de l'enregistreur client et la configurer à l'aide de l'exemple suivant:
import logging
logging.basicConfig(level=logging.INFO, format='[%(asctime)s - %(levelname)s] %(message).5000s')
logging.getLogger('google.ads.googleads.client').setLevel(logging.INFO)
Notez que l'enregistreur client est configuré lorsque le client est initialisé. Toutes les modifications apportées ultérieurement à la configuration de la journalisation seront ignorées. Afin de remplacer par programmation la configuration de la journalisation dans le fichier YAML, veillez à appeler les lignes ci-dessus avant l'initialisation du client.
Niveaux de journalisation
Le client génère des journaux à différents niveaux. Vous pouvez définir votre configuration pour afficher tout ou partie des éléments suivants:
Niveau | Requête 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 des objets de requête et d'exception complets au format JSON. |
INFO |
Résumé concis avec des champs de requête et de réponse spécifiques. | Journal détaillé avec des objets de requête et d'exception complets au format JSON. |
WARNING |
Aucun | Résumé concis contenant des informations spécifiques sur la demande, l'état de l'exception et le message. |
Étant donné que le framework de journalisation Python ignore les messages de journal dont la gravité est inférieure au niveau configuré, le paramètre WARNING
signifie que vous ne verrez que les messages concis liés aux requêtes ayant échoué, tandis que le paramètre DEBUG
signifie que vous verrez tous les types de journaux possibles dans le tableau ci-dessus.
Connexion au fichier...
Vous pouvez facilement rediriger des messages de journal vers un fichier, par exemple lorsque vous exécutez l'exemple get_campaigns
:
python get_campaigns.py -c $CLIENT_ID 2> example.log
Interceptions 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.