ขอแนะนำ google-ads-bom ในไลบรารีของไคลเอ็นต์ Google Ads API สำหรับ Java

วันพฤหัสบดีที่ 18 กันยายน 2025

เรายินดีที่จะประกาศเปิดตัว google-ads-bom สำหรับไลบรารีของไคลเอ็นต์ Google Ads API สำหรับ Java ซึ่งตอนนี้พร้อมใช้งานกับไลบรารีของไคลเอ็นต์ google-ads เวอร์ชัน 40.0.0 แล้ว รายการวัสดุ (BOM) ใหม่นี้ออกแบบมาเพื่อลดความซับซ้อนในการจัดการทรัพยากร Dependency และเพิ่มความเสถียรในการผสานรวม Google Ads API อย่างมาก

BOM คืออะไร

BOM เป็นเครื่องมือเวลาบิลด์ที่ให้ "กฎ" ที่เชื่อถือได้และรวมศูนย์สำหรับการจัดการเวอร์ชันทรัพยากร Dependency การนําเข้า BOM จะช่วยให้มั่นใจว่าโปรเจ็กต์ใช้ชุดเวอร์ชันทรัพยากร Dependency ที่เข้ากันได้ตรงกับที่สร้างและทดสอบไคลเอ็นต์ Google Ads ซึ่งจะช่วยหลีกเลี่ยงความขัดแย้งของทรัพยากร Dependency กับไลบรารีอย่าง Guava และ GAX ได้อย่างมาก ซึ่งเฟรมเวิร์กอื่นๆ อีกหลายเฟรมเวิร์กก็ใช้ไลบรารีเหล่านี้เช่นกัน

วิธีรวม google-ads-bom ไว้ในโค้ด

หากต้องการใช้ประโยชน์จาก google-ads-bom ให้นำเข้า ไปยังส่วน <dependencyManagement> ของไฟล์บิลด์ (เช่น 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'

การประกาศทรัพยากร Dependency ที่ครอบคลุมโดย google-ads-bom

BOM จะจัดการเวอร์ชันของไลบรารีทั่วไปหลายรายการโดยอัตโนมัติ เช่น Guava, Protobuf, GAX และ gRPC เพื่อให้ไลบรารีเหล่านี้เข้ากันได้ คุณไม่ควรระบุเวอร์ชันเมื่อประกาศทรัพยากร Dependency เหล่านี้เพื่อหลีกเลี่ยงความขัดแย้งของทรัพยากร Dependency ที่อาจเกิดขึ้น เช่น หากใช้ Guava คุณจะประกาศโดยไม่มีเวอร์ชัน ดังนี้

ใน Maven ให้ทำดังนี้

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

หรือใน Gradle ให้ทำดังนี้

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

หากต้องการดึงข้อมูลรายการทรัพยากร Dependency ที่ถูกจำกัดซึ่งสามารถนำเข้าโดยใช้ BOM โดยไม่มีเวอร์ชันที่ประกาศ ให้ใช้ listAllDependencyConstraints gradle task

ดูข้อมูลเพิ่มเติมเกี่ยวกับข้อเสนอ google-ads-bom ใหม่นี้และวิธีกำหนดค่าไคลเอ็นต์ Java ได้ในคู่มือเริ่มต้นใช้งาน

 - Sarah Pollack, ทีม Google Ads API

ป้ายกำกับ: google-ads-api