معرفی google-ads-bom به کتابخانه کارخواه Google Ads API برای Java

پنجشنبه، ۱۸ سپتامبر ۲۰۲۵

با خوشحالی انتشار google-ads-bom را برای کتابخانه کارخواه Google Ads API برای Java اعلام می‌کنیم که اکنون با نسخه v40.0.0 کتابخانه کارخواه google-ads دردسترس است. این «صورت مواد» (BOM) جدید برای ساده‌سازی قابل‌توجه مدیریت وابستگی شما و بهبود پایداری ادغام‌های Google Ads API شما طراحی شده است.

BOM چیست؟

‫BOM ابزاری برای زمان ساخت است که «کتاب قانون» متمرکز و معتبری برای مدیریت نسخه‌های وابستگی ارائه می‌دهد. با وارد کردن BOM ما، مطمئن می‌شوید که پروژه‌تان از مجموعه دقیق نسخه‌های وابستگی سازگار استفاده می‌کند که کارخواه Google Ads براساس آن‌ها ساخته و آزمایش شده است. این کار به‌طور قابل‌توجهی به جلوگیری از تداخل وابستگی با کتابخانه‌هایی مانند 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'

اعلام وابستگی‌های تحت‌پوشش 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، راهنمای شروع به کار ما را بررسی کنید.

 - Sarah Pollack، تیم Google Ads API

برچسب‌ها: google-ads-api