Stay organized with collections
Save and categorize content based on your preferences.
We recommend using the client library through Maven. We also provide binary
distributions on our releases page and through the Maven central
repository
(see our quick start guide for details). However, you can build
the library yourself using the following build process described.
The client library is built with Gradle. Dependencies are downloaded from the
Maven Central repository.
Install Java development kit
JDK 1.8 or later is required to build the library. We'll assume that Java is
installed on your machine for the purposes of this guide.
Build with Gradle
We recommend using the included Gradle wrapper. See
gradle/wrapper/gradle-wrapper.properties
for the current version. You do not need a separate Gradle installation.
Build the library
Clone this project in the directory of your choice. The .git suffix in the
URL is optional.
Run the following command to build the snapshot version of the library
and examples project.
./gradlewbuild
Export the client library to a local Maven repository.
./gradlewpublishToMavenLocal
Use the client library in a local Maven repository
After a successful build and export, the artifacts for the client library are
available to Maven/Gradle from the local repository (typically
~/.m2/repository/com/google/api-ads/google-ads/). Add a dependency on the
SNAPSHOT version that was just built to any subsequent project build files. The
version is defined in
gradle.properties.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 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)."]]
