חדש: google-ads-bom בספריית הלקוח של Google Ads API ל-Java

יום חמישי, 18 בספטמבר 2025

אנחנו שמחים להודיע על ההשקה של google-ads-bom לספריית הלקוח של Google Ads API ל-Java, שזמינה עכשיו בגרסה 40.0.0 של ספריית הלקוח של google-ads. ה-BOM החדש נועד לפשט משמעותית את ניהול התלויות ולשפר את היציבות של השילובים של Google Ads API.

מה זה BOM?

‫BOM הוא כלי לזמן פיתוח שמספק "ספר חוקים" מרכזי וסמכותי לניהול גרסאות של יחסי תלות. כשמייבאים את ה-BOM שלנו, מבטיחים שהפרויקט ישתמש בקבוצה המדויקת של גרסאות התלות התואמות שעל פיהן נבנה ונבדק לקוח Google Ads. כך אפשר להימנע מעימותים של תלויות עם ספריות כמו Guava ו-GAX, שגם משמשות הרבה מסגרות אחרות.

איך משלבים את google-ads-bom בקוד

כדי ליהנות מהיתרונות של google-ads-bom, צריך לייבא אותו לקטע <dependencyManagement> של קובץ ה-build (למשל, pom.xml ל-Maven או build.gradle ל-Gradle). לאחר מכן, צריך להשמיט את מפרט הגרסה מהתלות של google-ads בקטע <dependencies>.

איך לכלול את ה-BOM בפרויקט Maven:

<!-- Import the Bill of Materials (BOM) -->
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.google.api-ads</groupId>
            <artifactId>google-ads-bom</artifactId>
            <version>40.0.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<!-- Add the google-ads dependency without a version -->
<dependencies>
    <dependency>
        <groupId>com.google.api-ads</groupId>
        <artifactId>google-ads</artifactId>
    </dependency>
</dependencies>

איך כוללים את ה-BOM בפרויקט Gradle:

// Import the Bill of Materials (BOM).
implementation platform('com.google.api-ads:google-ads-bom:40.0.0')

// Add the google-ads dependency, without a version. The version is managed by the BOM.
implementation 'com.google.api-ads:google-ads'

הצהרה על יחסי תלות שכלולים ב-google-ads-bom

ה-BOM מנהל באופן אוטומטי את הגרסאות של כמה ספריות נפוצות, כמו Guava,‏ Protobuf,‏ GAX ו-gRPC, כדי שהן יהיו תואמות. כדי למנוע התנגשויות פוטנציאליות בין יחסי תלות, אל תציינו גרסה כשאתם מצהירים על יחסי התלות האלה. לדוגמה, אם אתם משתמשים ב-Guava, אתם צריכים להצהיר עליה בלי גרסה:

ב-Maven:

<dependency>
    <groupId>com.google.guava</groupId>
    <artifactId>guava</artifactId>
</dependency>

או ב-Gradle:

implementation 'com.google.guava:guava' // NO VERSION SPECIFIED.

כדי לאחזר רשימה של יחסי תלות מוגבלים שאפשר לייבא באמצעות ה-BOM בלי גרסה מוצהרת, משתמשים במשימת Gradle‏ listAllDependencyConstraints.

כדי לקבל מידע נוסף על המוצר החדש של google-ads-bom ועל הגדרת לקוח Java, אפשר לעיין במדריך לתחילת הדרך.

 – שרה פולק, צוות Google Ads API

תוויות: google-ads-api