बिल ऑफ़ मटीरियल

Google Ads API के लिए ज़रूरी कॉम्पोनेंट की सूची (बीओएम), डिपेंडेंसी के वर्शन मैनेज करता है. इससे Guava और GAX जैसी लाइब्रेरी के साथ डिपेंडेंसी के टकराव से बचा जा सकता है. इन लाइब्रेरी का इस्तेमाल अन्य फ़्रेमवर्क भी करते हैं. बीओएम यह पक्का करता है कि आपने इन डिपेंडेंसी के उन्हीं वर्शन का इस्तेमाल किया हो जिनकी जांच Google Ads क्लाइंट लाइब्रेरी के साथ की गई है.

क्लाइंट लाइब्रेरी के आर्टफ़ैक्ट इस्तेमाल करने का यह सबसे सही तरीका है.

Maven कॉन्फ़िगरेशन {#maven-configuration}

Maven डिपेंडेंसी यह है:

<!-- 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>41.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 कॉन्फ़िगरेशन

Gradle डिपेंडेंसी यह है:

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

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

बीओएम में शामिल डिपेंडेंसी का एलान करना

Google Ads API BOM में, कई सामान्य लाइब्रेरी के वर्शन मैनेज करने की सुविधा शामिल है. जैसे, Guava, Protobuf, GAX, और gRPC. डिपेंडेंसी से जुड़ी समस्याओं से बचने के लिए, बीओएम में शामिल डिपेंडेंसी का एलान करते समय, आपको वर्शन तय नहीं करना चाहिए. BOM, इन लाइब्रेरी के वर्शन को अपने-आप मैनेज करता है. इससे यह पक्का होता है कि ये लाइब्रेरी एक-दूसरे के साथ काम करती हैं.

उदाहरण के लिए, Maven में Guava डिपेंडेंसी का एलान करने के लिए, इसका इस्तेमाल करें:

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

Gradle में:

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

वर्शन को शामिल न करने पर, बीओएम इसे मैनेज करता है. इससे डिपेंडेंसी के ऐसे वर्शन की वजह से होने वाली समस्याओं को रोकने में मदद मिलती है जो काम नहीं करते. डिपेंडेंसी के टकराव के सामान्य इंडिकेटर में NoSuchMethodError या ClassNotFoundException शामिल हैं. इन्हें अक्सर इस बात की पुष्टि करके ठीक किया जा सकता है कि बीओएम मैनेज की गई सभी डिपेंडेंसी में कोई वर्शन तय नहीं किया गया है.