Java के लिए क्लाइंट लाइब्रेरी, GitHub पर होस्ट की जाती है. इसे Maven Central के ज़रिए डिस्ट्रिब्यूट किया जाता है. इसमें एपीआई का इस्तेमाल करने में आपकी मदद करने के लिए, कई सुविधाएं उपलब्ध हैं. इनमें क्रेडेंशियल को आसानी से मैनेज करना और Google Ads API सेवा के क्लाइंट बनाना शामिल है.
इस लाइब्रेरी के लिए, Java 8 या इसके बाद का वर्शन ज़रूरी है.
इंस्टॉल करने की सुविधा
डिपेंडेंसी के वर्शन मैनेज करने के लिए, अपनी pom.xml या
build.gradle फ़ाइल में, Google Ads API बिल ऑफ़ मटीरियल (BOM) का इस्तेमाल करें:
<!-- 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.0.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>
आपके पास सोर्स से लाइब्रेरी बनाने का विकल्प भी है.
अपना पहला एपीआई कॉल करना
Google Ads API का इस्तेमाल करने के लिए, आपको एपीआई का ऐक्सेस पाने और अपने Google Ads खातों को कॉन्फ़िगर करने के लिए, कई चरण पूरे करने होंगे. क्विक स्टार्ट गाइड देखें. इसमें Google Ads खातों को सेट अप करने जैसे सभी ज़रूरी चरणों के बारे में बताया गया है.
बुनियादी इस्तेमाल
प्रोजेक्ट सेट अप करने, सेवा क्लाइंट इंस्टैंशिएट करने, और Java क्लाइंट लाइब्रेरी के साथ कोड के उदाहरण चलाने का तरीका जानने के लिए, बुनियादी इस्तेमाल की गाइड देखें.
पुष्टि करना और अनुमति देना
Java क्लाइंट लाइब्रेरी, पुष्टि करने और अनुमति देने के कई तरीकों के साथ काम करती है. इनमें OAuth 2.0 डेस्कटॉप और वेब ऐप्लिकेशन फ़्लो, सेवा खाते, और ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल शामिल हैं. ज़्यादा जानने के लिए, पुष्टि करने और अनुमति देने की गाइड देखें.
कॉन्फ़िगरेशन और लॉगिंग
Java क्लाइंट लाइब्रेरी, कॉन्फ़िगरेशन के कई विकल्पों के साथ काम करती है
. इनमें ads.properties फ़ाइलें, एनवायरमेंट वैरिएबल, और प्रोग्राम के ज़रिए कॉन्फ़िगरेशन शामिल हैं. साथ ही, इसमें एपीआई के अनुरोधों और जवाबों को ट्रैक करने के लिए, लॉगिंग की सुविधाएं भी उपलब्ध हैं
.
उपयोगिताएं
Java क्लाइंट लाइब्रेरी में, एपीआई की उपयोगिता को बेहतर बनाने के लिए यूटिलिटी क्लास शामिल हैं. ज़्यादा जानने के लिए, यहां दी गई गाइड देखें:
- FieldMasks: अपडेट फ़ील्ड मास्क बनाने और उनकी गिनती करने में मदद करने वाले टूल.
- ResourceNames: एंटिटी के संसाधन के नाम वाली स्ट्रिंग को फ़ॉर्मैट करने के लिए यूटिलिटी.
- ज़्यादा समय तक चलने वाली कार्रवाई: एसिंक्रोनस एपीआई के ऑपरेशंस की निगरानी करने और उन्हें मैनेज करने में मदद करने वाले टूल.
अपने ऐप्लिकेशन को बेहतर बनाना
अपने ऐप्लिकेशन के टाइम आउट, फिर से कोशिश करने की सेटिंग, स्टार्टअप लेटेंसी, और डिपेंडेंसी मैनेजमेंट को बेहतर बनाने के बारे में सुझाव पाने के लिए, बेहतर इस्तेमाल की गाइड देखें.