बुनियादी इस्तेमाल

Java क्लाइंट लाइब्रेरी का बुनियादी इस्तेमाल इस तरह किया जाता है:

Maven या Gradle का नया प्रोजेक्ट बनाना

अपनी पसंद के IDE में, Maven या Gradle का नया प्रोजेक्ट बनाएं. हमारे आर्टफ़ैक्ट को Maven Central डेटा संग्रह में पब्लिश किया जाता है.

हमारा सुझाव है कि डिपेंडेंसी के वर्शन मैनेज करने के लिए, Google Ads API के बिल ऑफ़ मटीरियल (BOM) का इस्तेमाल करें.

सोर्स से भी बनाया जा सकता है. इस गाइड के लिए, यह मान लिया गया है कि आपके पास ज़रूरी डिपेंडेंसी वाला प्रोजेक्ट सेटअप है.

अगर सोर्स से बनाया जा रहा है, तो पक्का करें कि आपने अपने IDE में एनोटेशन प्रोसेसिंग चालू की हो.

एपीआई ऐक्सेस कॉन्फ़िगर करना

Google Ads API से कनेक्ट करने के लिए, आपको पुष्टि करने और अनुमति देने के क्रेडेंशियल देने होंगे. ज़रूरी क्रेडेंशियल और क्लाइंट लाइब्रेरी को कॉन्फ़िगर करने के तरीके के बारे में जानने के लिए, पुष्टि और अनुमति देने से जुड़ी गाइड देखें.

पहला कॉल करना

क्रेडेंशियल कॉन्फ़िगर करने के बाद, आप अपना पहला एपीआई कॉल करने के लिए तैयार हैं.

क्रेडेंशियल की पुष्टि करने और पहला कॉल करने के लिए, हम GetCampaigns उदाहरण चलाएंगे.

सबसे पहले, google-ads-examples डायरेक्ट्री पर जाएं.

cd google-ads-examples

इस उदाहरण के लिए, --customerId पैरामीटर की ज़रूरत होती है. इसकी वैल्यू, डैश के बिना आपका Google Ads खाते का ग्राहक आईडी होती है.

Gradle के साथ चलाने के लिए:

./gradlew -q runExample --example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"

अन्य उदाहरण देखना

google-ads-examples में मौजूद उदाहरणों के पैकेज में, कई काम के उदाहरण शामिल हैं. ज़्यादातर उदाहरणों के लिए, पैरामीटर ज़रूरी होते हैं. पैरामीटर को आर्ग्युमेंट के तौर पर पास किया जा सकता है (सुझाया जाता है) या सोर्स कोड में INSERT_XXXXX_HERE वैल्यू में बदलाव किया जा सकता है. किसी उदाहरण के इस्तेमाल का स्टेटमेंट देखने के लिए, --help को सिर्फ़ आर्ग्युमेंट के तौर पर पास करें.

Gradle के साथ:

./gradlew -q runExample --example="basicoperations.GetCampaigns --help"

Gradle में listExamples टास्क का इस्तेमाल करके, सभी उदाहरण, किसी सबडायरेक्ट्री में मौजूद उदाहरण या ऐसे उदाहरणों की सूची भी देखी जा सकती है जिनमें ब्यौरे में कोई खोज शब्द शामिल हो.

# List all examples:
./gradlew -q listExamples
# List examples in the 'basicoperations' subdirectory:
./gradlew -q listExamples --subdirectory='basicoperations'
# Search for examples where the description includes 'Performance Max':
./gradlew -q listExamples --searchTerm='Performance Max'