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