Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A geração de registros é configurada com o SLF4J, uma biblioteca genérica de geração de registros para Java, que
permite que os registros sejam direcionados a muitas implementações diferentes. Fornecemos arquivos de configuração para log4j 1.2/2 e Java Util Logging (JUL).
Layout e funcionalidade de registro
As solicitações são registradas com um resumo de uma linha e o corpo e os cabeçalhos completos da solicitação/resposta.
Tipo de registro
Nome do registro
Nível de sucesso
Nível de falha
RESUMO
com.google.ads.googleads.lib.request.summary
INFO
WARN
DETALHE
com.google.ads.googleads.lib.request.detail
DEBUG
INFO
Truncagem de registros detalhados
Os registros detalhados são truncados por padrão para evitar a criação de registros grandes. Para mudar o tamanho em que os registros são truncados, defina -Dapi.googleads.maxLogMessageLength=<number>. Definir -1 desativa o truncamento de registros.
Log4j2
Adicione uma dependência à biblioteca log4j-slf4j-impl, substituindo
2.x.y pela versão do Log4j 2 que você está usando no projeto.
(Opcional) Crie um arquivo de configuração no diretório de recursos, por exemplo, no Maven: src/main/resources. O Log4j 2 carrega o arquivo de configuração do classpath, não do diretório de trabalho. Portanto, crie em um diretório de recursos.
Execute o aplicativo, especificando
-Dlog4j.configurationFile=<CONFIG_FILE_PATH>. É possível especificar CONFIG_FILE_PATH=googleads-logging/log4j2.xml para usar o arquivo de configuração padrão incluído nas bibliotecas de cliente.
Log4j 1.2 (legado)
Adicione uma dependência à biblioteca slf4j-log4j12, substituindo 1.x.y pela versão do Log4j 1.2 que você está usando no projeto.
(Opcional) Crie um arquivo de configuração no diretório de recursos dos projetos. Por exemplo, no Maven, o caminho é src/main/resources. O Log4j 1.2 carrega o arquivo de configuração do classpath, não do diretório de trabalho. Portanto, copie para um diretório de recursos.
Execute o aplicativo, especificando -Dlog4j.configuration=<CONFIG_FILE_PATH>.
É possível especificar CONFIG_FILE_PATH=googleads-logging/log4j.properties para usar o arquivo de configuração padrão incluído nas bibliotecas de cliente.
Java Util Logging
Adicione uma dependência à biblioteca slf4j-jdk14.
Crie um arquivo de configuração do JUL no sistema de arquivos em um caminho legível pelo
aplicativo (por exemplo, ./jdk-logger.properties). Um modelo é
fornecido em
google-ads/src/main/resources/googleads-logging/jdk-logger.properties. O JUL
lê apenas do sistema de arquivos. Portanto, não copie para o diretório de recursos.
Execute o aplicativo especificando
-Djava.util.logging.config.file=./jdk-logger.properties.
[null,null,["Última atualização 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`."]]
