Pour discuter de nos produits et nous faire part de vos commentaires, rejoignez le canal Discord officiel Google Ads sur le serveur de la communauté Google Advertising and Measurement.
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
La journalisation est configurée avec SLF4J, une bibliothèque de journalisation générique pour Java, qui permet de diriger les journaux vers de nombreuses implémentations de journalisation différentes. Nous fournissons des fichiers de configuration pour log4j 1.2/2 et Java Util Logging (JUL).
Mise en page et fonctionnalité de la journalisation
Les requêtes sont consignées avec un résumé d'une ligne, ainsi que le corps et les en-têtes complets de la requête/réponse.
Type de journal
Nom du journal
Niveau de réussite
Niveau d'échec
RÉSUMÉ
com.google.ads.googleads.lib.request.summary
INFO
WARN
DÉTAILS
com.google.ads.googleads.lib.request.detail
DEBUG
INFO
Troncation du journal détaillé
Les journaux détaillés sont tronqués par défaut pour éviter de créer des journaux volumineux. Pour modifier la longueur à laquelle les journaux sont tronqués, définissez -Dapi.googleads.maxLogMessageLength=<number>. Si vous définissez -1, la troncature des journaux est désactivée.
Log4j 2
Ajoutez une dépendance à la bibliothèque log4j-slf4j-impl en remplaçant 2.x.y par la version de Log4j 2 que vous utilisez dans votre projet.
(Facultatif) Créez un fichier de configuration dans votre répertoire de ressources, par exemple dans Maven : src/main/resources. Log4j 2 charge son fichier de configuration à partir du classpath, et non du répertoire de travail. Assurez-vous donc de le créer dans un répertoire de ressources.
Exécutez votre application en spécifiant -Dlog4j.configurationFile=<CONFIG_FILE_PATH>. Vous pouvez spécifier CONFIG_FILE_PATH=googleads-logging/log4j2.xml pour utiliser le fichier de configuration par défaut inclus avec les bibliothèques clientes.
Log4j 1.2 (ancienne version)
Ajoutez une dépendance à la bibliothèque slf4j-log4j12, en remplaçant 1.x.y par la version de Log4j 1.2 que vous utilisez dans votre projet.
(Facultatif) Créez un fichier de configuration dans le répertoire des ressources de votre projet. Par exemple, dans Maven, le chemin d'accès est src/main/resources. Log4j 1.2 charge son fichier de configuration à partir du classpath, et non du répertoire de travail. Assurez-vous donc de le copier dans un répertoire de ressources.
Exécutez votre application en spécifiant -Dlog4j.configuration=<CONFIG_FILE_PATH>.
Vous pouvez spécifier CONFIG_FILE_PATH=googleads-logging/log4j.properties pour utiliser le fichier de configuration par défaut inclus avec les bibliothèques clientes.
Journalisation Java Util
Ajoutez une dépendance à la bibliothèque slf4j-jdk14.
Créez un fichier de configuration JUL sur le système de fichiers dans un chemin d'accès lisible depuis votre application (par exemple, ./jdk-logger.properties). Un modèle est fourni à l'adresse google-ads/src/main/resources/googleads-logging/jdk-logger.properties. JUL lit uniquement à partir du système de fichiers. Ne copiez donc pas dans le répertoire des ressources.
Exécutez votre application en spécifiant -Djava.util.logging.config.file=./jdk-logger.properties.
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/27 (UTC).
[null,null,["Dernière mise à jour le 2025/08/27 (UTC)."],[[["\u003cp\u003eLogging is managed through SLF4J, offering flexibility with log4j 1.2/2 and Java Util Logging configurations.\u003c/p\u003e\n"],["\u003cp\u003eRequest logging includes a summary line along with detailed request/response bodies and headers at configurable log levels.\u003c/p\u003e\n"],["\u003cp\u003eDetailed logs are truncated by default, adjustable via the \u003ccode\u003e-Dapi.googleads.maxLogMessageLength\u003c/code\u003e system property.\u003c/p\u003e\n"],["\u003cp\u003eConfiguration instructions and examples are provided for setup with Log4j 2, Log4j 1.2, and Java Util Logging.\u003c/p\u003e\n"]]],[],null,["# Logging is configured with SLF4J a generic logging library for Java, which\nallows logs to be directed to many different logging implementations. We provide\nconfiguration files for log4j 1.2/2 and Java Util Logging (JUL).\n\nLogging layout and functionality\n--------------------------------\n\nRequests are logged with a one line summary and the full request/response body\nand headers.\n\n| Log type | Log name | Success level | Failure level |\n|----------|----------------------------------------------|---------------|---------------|\n| SUMMARY | com.google.ads.googleads.lib.request.summary | INFO | WARN |\n| DETAIL | com.google.ads.googleads.lib.request.detail | DEBUG | INFO |\n\n| **Key Point:** Mutate requests where [Partial\n| failure](/google-ads/api/samples/handle-partial-failure) is true won't cause the entire request to fail. Thus, partial failure logs are always logged at Success level, not at Failure level as might be expected.\n\nDetail Log Truncation\n---------------------\n\nThe detailed logs are truncated by default to avoid creating large logs. To\nchange the length at which logs are truncated, set\n`-Dapi.googleads.maxLogMessageLength=\u003cnumber\u003e`. Setting `-1` disables\nlog truncation.\n\nLog4j 2\n-------\n\n1. Add a dependency on the `log4j-slf4j-impl` library, substituting\n `2.x.y` with the version of Log4j 2 you are using in your project.\n\n \u003cdependency\u003e\n \u003cgroupId\u003eorg.apache.logging.log4j\u003c/groupId\u003e\n \u003cartifactId\u003elog4j-slf4j-impl\u003c/artifactId\u003e\n \u003cversion\u003e2.x.y\u003c/version\u003e\n \u003c/dependency\u003e\n\n2. (Optional) Create a configuration file in your resources directory, for\n example, in Maven: `src/main/resources`. Log4j 2 loads its configuration\n file from the classpath, not the working directory, so ensure you create in a\n resources directory.\n\n3. Run your application, specifying\n `-Dlog4j.configurationFile=\u003cCONFIG_FILE_PATH\u003e`. You can specify\n `CONFIG_FILE_PATH=googleads-logging/log4j2.xml` to use the default\n configuration file included with the client libraries.\n\nLog4j 1.2 (legacy)\n------------------\n\n1. Add a dependency on the `slf4j-log4j12` library, substituting `1.x.y` with\n the version of Log4j 1.2 you are using in your project.\n\n \u003cdependency\u003e\n \u003cgroupId\u003eorg.slf4j\u003c/groupId\u003e\n \u003cartifactId\u003eslf4j-log4j12\u003c/artifactId\u003e\n \u003cversion\u003e1.x.y\u003c/version\u003e\n \u003c/dependency\u003e\n\n2. (Optional) Create a configuration file in your projects resources directory,\n for example, in Maven, path is `src/main/resources`. Log4j 1.2 loads its\n configuration file from the classpath, not the working directory, so ensure\n you copy to a resources directory.\n\n3. Run your application, specifying `-Dlog4j.configuration=\u003cCONFIG_FILE_PATH\u003e`.\n You can specify `CONFIG_FILE_PATH=googleads-logging/log4j.properties` to use\n the default configuration file includedwith the client libraries.\n\nJava Util Logging\n-----------------\n\n1. Add a dependency on the `slf4j-jdk14` library.\n\n \u003cdependency\u003e\n \u003cgroupId\u003eorg.slf4j\u003c/groupId\u003e\n \u003cartifactId\u003eslf4j-jdk14\u003c/artifactId\u003e\n \u003cversion\u003e1.7.25\u003c/version\u003e\n \u003c/dependency\u003e\n\n2. Create a JUL configuration file on the file system in a path readable from\n your application (for instance, `./jdk-logger.properties`). A template is\n provided at\n `google-ads/src/main/resources/googleads-logging/jdk-logger.properties`. JUL\n reads from the filesystem only, so do not copy to the resources directory.\n\n3. Run your application specifying\n `-Djava.util.logging.config.file=./jdk-logger.properties`."]]
