קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
מומלץ להשתמש בספריית הלקוח דרך Maven. אנחנו מספקים גם הפצות בינאריות בדף הגרסאות שלנו ובאמצעות מאגר Maven Central (פרטים נוספים זמינים במדריך למתחילים). עם זאת, אתם יכולים ליצור את הספרייה בעצמכם באמצעות תהליך ה-build שמתואר בהמשך.
ספריית הלקוח מבוססת על Gradle. יחסי התלות יורדים ממאגר Maven Central.
התקנת ערכת פיתוח ל-Java
כדי ליצור את הספרייה, נדרשת גרסה JDK 1.8 ואילך. לצורך המדריך הזה, נניח ש-Java מותקנת במחשב שלכם.
מריצים את הפקודה הבאה כדי ליצור את גרסת התמונה של הספרייה ואת פרויקט הדוגמאות.
./gradlewbuild
מייצאים את ספריית הלקוח למאגר Maven מקומי.
./gradlewpublishToMavenLocal
שימוש בספריית הלקוח במאגר Maven מקומי
אחרי בנייה וייצוא מוצלחים, הארטיפקטים של ספריית הלקוח זמינים ל-Maven/Gradle מהמאגר המקומי (בדרך כלל ~/.m2/repository/com/google/api-ads/google-ads/). מוסיפים תלות בגרסת ה-SNAPSHOT שנבנתה זה עתה לכל קובץ בנייה של פרויקט עתידי. הגרסה מוגדרת ב-gradle.properties.
[null,null,["עדכון אחרון: 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)."]]