Como criar a biblioteca de cliente para Java a partir da origem
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Recomendamos usar a biblioteca de cliente pelo Maven. Também oferecemos distribuições binárias na página de versões e no repositório central do Maven. Consulte o guia de início rápido para mais detalhes. No entanto, é possível criar
a biblioteca por conta própria usando o processo de build a seguir.
A biblioteca de cliente é criada com o Gradle. As dependências são baixadas do repositório
Maven Central.
Instalar o Java Development Kit
O JDK 1.8 ou mais recente é necessário para criar a biblioteca. Vamos presumir que o Java está instalado na sua máquina para fins deste guia.
Criar com o Gradle
Recomendamos usar o wrapper Gradle incluído. Consulte
gradle/wrapper/gradle-wrapper.properties
para ver a versão atual. Não é necessário ter uma instalação separada do Gradle.
Criar a biblioteca
Clone esse projeto no diretório de sua escolha. O sufixo .git no
URL é opcional.
Execute o comando a seguir para criar a versão de snapshot da biblioteca
e do projeto de exemplos.
./gradlewbuild
Exporte a biblioteca de cliente para um repositório Maven local.
./gradlewpublishToMavenLocal
Usar a biblioteca de cliente em um repositório local do Maven
Depois de uma compilação e exportação bem-sucedidas, os artefatos da biblioteca de cliente ficam
disponíveis para Maven/Gradle no repositório local (normalmente
~/.m2/repository/com/google/api-ads/google-ads/). Adicione uma dependência na
versão SNAPSHOT que acabou de ser criada a qualquer arquivo de build de projeto subsequente. A
versão é definida em
gradle.properties.
[null,null,["Última atualização 2025-08-26 UTC."],[[["\u003cp\u003eThe Google Ads client library is best used through Maven, with binary distributions also available.\u003c/p\u003e\n"],["\u003cp\u003eBuilding the library requires JDK 1.8 or later and is accomplished using the included Gradle wrapper.\u003c/p\u003e\n"],["\u003cp\u003eAfter building, the library can be exported to a local Maven repository for use in other projects.\u003c/p\u003e\n"],["\u003cp\u003eThe library is built from the google-ads-java Github repository and can be used in Maven or Gradle projects.\u003c/p\u003e\n"]]],[],null,["# Building the client library for Java from source\n\nWe recommend using the client library through Maven. We also provide binary\ndistributions on our releases page and through the [Maven central\nrepository](//search.maven.org/artifact/com.google.api-ads/google-ads)\n(see our [quick start](/google-ads/api/docs/client-libs/java/quick-start) guide for details). However, you can build\nthe library yourself using the following build process described.\n\nThe client library is built with Gradle. Dependencies are downloaded from the\nMaven Central repository.\n| **Note:** If you build the library from source, ensure that you enable annotation processing in your IDE.\n\nInstall Java development kit\n----------------------------\n\nJDK 1.8 or later is required to build the library. We'll assume that Java is\ninstalled on your machine for the purposes of this guide.\n\nBuild with Gradle\n-----------------\n\nWe recommend using the included Gradle wrapper. See\n[`gradle/wrapper/gradle-wrapper.properties`](https://github.com/googleads/google-ads-java/blob/HEAD/gradle.properties)\nfor the current version. You do not need a separate Gradle installation.\n\n### Build the library\n\n1. Clone this project in the directory of your choice. The `.git` suffix in the\n URL is optional.\n\n git clone https://github.com/googleads/google-ads-java.git\n\n2. Navigate to the `google-ads-java` directory.\n\n cd google-ads-java\n\n3. Run the following command to build the snapshot version of the library\n and examples project.\n\n ./gradlew build\n\n | **Note:** On Windows, use `gradlew` instead of `./gradlew`.\n4. Export the client library to a local Maven repository.\n\n ./gradlew publishToMavenLocal\n\n | **Note:** You can export the library to a local repository even if you have not used or installed Maven previously. Directories are created as needed.\n\nUse the client library in a local Maven repository\n--------------------------------------------------\n\nAfter a successful build and export, the artifacts for the client library are\navailable to Maven/Gradle from the local repository (typically\n`~/.m2/repository/com/google/api-ads/google-ads/`). Add a dependency on the\nSNAPSHOT version that was just built to any subsequent project build files. The\nversion is defined in\n[gradle.properties](https://github.com/googleads/google-ads-java/blob/main/gradle.properties)."]]
