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

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

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

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

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

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

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

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

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

पहला कॉल करना

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

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

सबसे पहले, 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 में मौजूद 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'