تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

قائمة المواد

تتولّى قائمة المواد (BOM) في Google Ads API إدارة إصدارات التبعيات لتجنُّب تعارضات التبعيات مع مكتبات مثل Guava وGAX التي تستخدمها أيضًا أُطر عمل أخرى. تضمن قائمة المواد استخدام الإصدارات الدقيقة من هذه التبعيات التي تم اختبارها باستخدام مكتبة عملاء "إعلانات Google".

هذه هي الطريقة التي ننصح بها لاستخدام عناصر مكتبة العميل.

إعدادات Maven

أضِف قائمة مكونات الصنف إلى <dependencyManagement> وأعلِن عن google-ads في ملف pom.xml:

<!-- Import the Bill of Materials (BOM) to ensure you're using compatible
     versions of all google-ads libraries. -->
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.api-ads</groupId>
      <artifactId>google-ads-bom</artifactId>
      <version>48.1.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<!-- Add the google-ads dependency, without a version. The version is
     managed by the BOM. -->
<dependency>
  <groupId>com.google.api-ads</groupId>
  <artifactId>google-ads</artifactId>
</dependency>

إعدادات Gradle

يتيح الإصدار 5.0 من Gradle والإصدارات الأحدث استيراد قائمة مكونات الصنف (BOM) بشكلٍ أصلي باستخدام platform().

في Groovy DSL‏ (build.gradle):

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

// Add the google-ads dependency, without a version.
implementation 'com.google.api-ads:google-ads'

في Kotlin DSL (build.gradle.kts):

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

// Add the google-ads dependency, without a version.
implementation("com.google.api-ads:google-ads")

تحديد التبعيات التي تغطيها قائمة المواد

يتضمّن قائمة مكونات Google Ads API إدارة الإصدارات لعدة مكتبات شائعة، مثل Guava وProtobuf وGAX وgRPC. لتجنُّب التعارضات المحتملة في التبعيات، يجب عدم تحديد إصدار عند الإعلان عن التبعيات التي تغطيها قائمة المواد. تدير قائمة المواد تلقائيًا إصدارات هذه المكتبات، ما يضمن التوافق.

على سبيل المثال، للإعلان عن تبعية Guava في Maven، استخدِم ما يلي:

<dependency>
  <groupId>com.google.guava</groupId>
  <artifactId>guava</artifactId>
  <!-- NO VERSION SPECIFIED -->
</dependency>

في Gradle Groovy DSL ‏ (build.gradle):

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

في Gradle Kotlin DSL (build.gradle.kts):

implementation("com.google.guava:guava") // NO VERSION SPECIFIED

من خلال حذف الإصدار، يمكنك السماح لـ BOM بإدارته، ما يساعد في منع المشاكل الناتجة عن إصدارات التبعيات غير المتوافقة. تشمل المؤشرات الشائعة لتعارضات التبعية NoSuchMethodError أو ClassNotFoundException، والتي يمكن حلّها غالبًا من خلال التأكّد من عدم تحديد إصدار لجميع التبعيات التي تديرها قائمة المواد (BOM).

قائمة المواد تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

إعدادات Maven

إعدادات Gradle

تحديد التبعيات التي تغطيها قائمة المواد

قائمة المواد