لمحة عن 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) هي أداة لوقت الإنشاء توفّر "قواعد" مركزية وموثوقة لإدارة إصدارات التبعيات. من خلال استيراد قائمة المواد، يمكنك التأكّد من أنّ مشروعك يستخدم المجموعة الدقيقة من إصدارات التبعيات المتوافقة التي تم إنشاء عميل "إعلانات Google" واختباره وفقًا لها. يساعد ذلك بشكل كبير في تجنُّب تعارضات التبعية مع مكتبات مثل Guava وGAX، والتي تستخدمها أيضًا العديد من أُطر العمل الأخرى.

كيفية دمج google-ads-bom في الرمز البرمجي

للاستفادة من مزايا google-ads-bom، عليك استيرادها إلى قسم <dependencyManagement> في ملف الإصدار (مثل pom.xml لـ Maven أو build.gradle لـ Gradle). بعد ذلك، عليك حذف مواصفات الإصدار من تبعية google-ads في قسم <dependencies>.

كيفية تضمين قائمة المواد في مشروع 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>

كيفية تضمين قائمة المواد في مشروع 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

تدير قائمة المواد تلقائيًا إصدارات العديد من المكتبات الشائعة، مثل 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