Journalisation
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Vous pouvez enregistrer les requêtes, les réponses et les messages récapitulatifs envoyés à l'API Google Ads dans votre propre enregistreur personnalisé ou dans un enregistreur par défaut de la bibliothèque Ruby.
Niveaux de journalisation
La bibliothèque consigne différents types d'événements à différents niveaux de journalisation. Si la réponse de l'API aboutit, le résumé est consigné à l'adresse INFO, et 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, et la requête complète et la réponse sont consignées à l'adresse INFO.
Pour les échecs partiels, les détails de l'échec partiel sont consignés à DEBUG.
Configuration
L'enregistreur peut être configuré dans le cadre de votre configuration google_ads_config.rb. Vous pouvez configurer un enregistreur par défaut en spécifiant les champs log_level et log_target, ou spécifier entièrement votre propre enregistreur en spécifiant logger. Si vous spécifiez logger, log_level et log_target seront ignorés.
Vous pouvez également spécifier un enregistreur après avoir instancié le client à l'aide de client.logger=.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/21 (UTC).
[null,null,["Dernière mise à jour le 2025/08/21 (UTC)."],[[["\u003cp\u003eThe Google Ads API Ruby library allows logging of requests, responses, and summaries to custom or default loggers.\u003c/p\u003e\n"],["\u003cp\u003eDifferent log levels are used for successful responses (\u003ccode\u003eINFO\u003c/code\u003e, \u003ccode\u003eDEBUG\u003c/code\u003e) and errors (\u003ccode\u003eWARN\u003c/code\u003e, \u003ccode\u003eINFO\u003c/code\u003e, \u003ccode\u003eDEBUG\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eLogging can be configured through the \u003ccode\u003egoogle_ads_config.rb\u003c/code\u003e file using \u003ccode\u003elog_level\u003c/code\u003e, \u003ccode\u003elog_target\u003c/code\u003e, or a custom \u003ccode\u003elogger\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAfter client instantiation, the logger can be specified using \u003ccode\u003eclient.logger=\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Logging\n\nRequests, responses, and summary messages made to the Google Ads API can be\nlogged to your own custom logger or a default logger in the Ruby library.\n\nLog Levels\n----------\n\nThe library will log different types of events to different log levels. On a\nsuccessful API response, the summary will be logged at `INFO`, and the full\nrequest and responses will be logged at `DEBUG`. On a request that resulted in\nan API error, the summary message will be logged at `WARN` and the full request\nand response will be logged at `INFO`.\n\nFor partial failures, the partial failure details will be logged at `DEBUG`.\n\nConfiguration\n-------------\n\nThe logger can be configured as part of your\n[google_ads_config.rb](https://github.com/googleads/google-ads-ruby/blob/HEAD/google_ads_config.rb)\nconfiguration. You can set up a default logger by specifying the `log_level` and\n`log_target` fields, or you can specify your own logger entirely by specifying\n`logger`. If you specify `logger`, then `log_level` and `log_target` will be\nignored.\n\nYou can also specify a logger after instantiating the client using\n`client.logger=`."]]
