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

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

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

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

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

अगर आपको google-ads-examples मॉड्यूल में शामिल, पहले से पैकेज किए गए कोड के उदाहरण चलाने हैं, तो GitHub से google-ads-java रिपॉज़िटरी को क्लोन करें या सोर्स से बनाएं. अगर आपको सोर्स से बनाना है, तो पक्का करें कि आपने अपने IDE में एनोटेशन प्रोसेसिंग चालू की हो.

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

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

अपना पहला कॉल करना

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

अपने क्रेडेंशियल की पुष्टि करने और क्लोन की गई google-ads-java रिपॉज़िटरी का इस्तेमाल करके पहला कॉल करने के लिए, GetCampaigns उदाहरण चलाएं.

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

cd google-ads-examples

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

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

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

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

mvn exec:java \
  -Dexec.mainClass="com.google.ads.googleads.examples.basicoperations.GetCampaigns" \
  -Dexec.args="--customerId INSERT_CUSTOMER_ID_HERE"

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

google-ads-examples में मौजूद examples पैकेज में कई काम के उदाहरण दिए गए हैं. ज़्यादातर उदाहरणों के लिए, पैरामीटर ज़रूरी होते हैं. पैरामीटर को आर्ग्युमेंट के तौर पर पास किया जा सकता है (सुझाया गया) या सोर्स कोड में INSERT_..._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'