शुरू करें

हमारा सुझाव है कि आप Apache Maven या Gradle के साथ क्लाइंट लाइब्रेरी का इस्तेमाल करें.

नया Maven/Gredle प्रोजेक्ट बनाएं

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

Maven डिपेंडेंसी:

<dependency>
  <groupId>com.google.api-ads</groupId>
  <artifactId>google-ads</artifactId>
  <version>33.0.0</version>
</dependency>

Gradle डिपेंडेंसी:

implementation 'com.google.api-ads:google-ads:33.0.0'

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

एपीआई से पुष्टि करने के लिए क्रेडेंशियल पाएं

Google Ads API को ऐक्सेस करने के लिए, OAuth क्रेडेंशियल और Google Ads API डेवलपर की ज़रूरत होती है टोकन. इस सेक्शन में बताया गया है कि ये क्या हैं, इनका इस्तेमाल कैसे किया जाता है, और ये कैसे काम करती हैं मिल गए हैं.

डेवलपर टोकन (एपीआई ऐक्सेस करने के लिए)

डेवलपर टोकन किसी मैनेजर से लिंक किया गया है खाते के रूप में मौजूद है और इसे Google Ads वेब इंटरफ़ेस में देखा जा सकता है.

भले ही डेवलपर टोकन किसी मैनेजर खाते से लिंक किया गया है, लेकिन यह उस खाते का ऐक्सेस नहीं है. इसके बजाय, डेवलपर टोकन है और खाता लेवल पर ऐक्सेस, OAuth के ज़रिए कॉन्फ़िगर किया जाता है.

OAuth क्रेडेंशियल (Google Ads खातों को ऐक्सेस करने के लिए)

Google Ads खातों का ऐक्सेस रखने वाले Google खाते के उपयोगकर्ताओं के तौर पर अनुमति देने के लिए, आपको OAuth क्रेडेंशियल का एक सेट देना ज़रूरी है.

आम तौर पर, दो तरह के OAuth फ़्लो इस्तेमाल किए जाते हैं: डेस्कटॉप (इंस्टॉल किया गया) ऐप्लिकेशन या वेब ऐप्लिकेशन. दोनों के बीच मुख्य अंतर यह है कि डेस्कटॉप ऐप्लिकेशन के लिए सिस्टम ब्राउज़र खोलें और से मिलने वाले जवाबों को मैनेज करने के लिए, एक लोकल रीडायरेक्ट यूआरआई उपलब्ध कराएं Google का ऑथराइज़ेशन सर्वर, जबकि वेब ऐप्लिकेशन किसी आर्बिट्रेरी प्राधिकरण पूरा करने और क्रेडेंशियल वापस भेजने के लिए तृतीय-पक्ष ब्राउज़र आपका सर्वर. यह लाइब्रेरी, आम तौर पर कम इस्तेमाल किए जाने वाले सेवा खाते के साथ भी काम करती है फ़्लो.

अपने क्रेडेंशियल का इस्तेमाल करके अनुमति देने पर (डेस्कटॉप ऐप्लिकेशन का फ़्लो)
OAuth डेस्कटॉप ऐप्लिकेशन का इस्तेमाल करें फ़्लो के दौरान बनाया जाता है. इसमें वे सारी जानकारी शामिल है जो आपने को अपने क्रेडेंशियल से अनुमति देनी होगी.
तीसरे पक्ष के Google उपयोगकर्ता के तौर पर अनुमति देने पर (वेब फ़्लो)
OAuth वेब ऐप्लिकेशन फ़्लो देखें. यह में एक उदाहरण दिया गया है. इसमें, आर्बिट्रेरी तीसरे पक्ष के लिए OAuth की अनुमति सेट अप करने के तरीके का उदाहरण दिया गया है उपयोगकर्ता.
यदि आप Google Apps डोमेन उपयोगकर्ता (सेवा खाता प्रवाह) के रूप में अधिकृत करते हैं
OAuth सेवा खाता) देखें फ़्लो के दौरान बनाया जाता है. इसमें उदाहरण के तौर पर बताया गया है कि Google Apps डोमेन उपयोगकर्ताओं के लिए OAuth प्राधिकरण सेट अप करें.

अगर Google Ads ग्राहक खाते को आपका ऐक्सेस, Google Ads मैनेजर के ज़रिए मिला है खाते के लिए, आपको नीचे बताए गए तरीके से एक लॉगिन ग्राहक आईडी भी बताना होगा.

लॉगिन ग्राहक आईडी (मैनेजर खाते से Google Ads खातों को ऐक्सेस करने के लिए)

इसके अलावा, मैनेजर खाते का वह ग्राहक आईडी डालें जो विज्ञापन दिखाने वाला खाता है. अगर आपको ग्राहक ऐक्सेस करने की ज़रूरत है, तो यह बताना ज़रूरी है यह खाता एक मैनेजर खाते के ज़रिए बनाया गया है. सभी मैनेजर की जानकारी देने की ज़रूरत नहीं है खाते के ग्राहक आईडी के पथ पर मौजूद होते हैं, जो सिर्फ़ सबसे ऊपर वाला मैनेजर आईडी होता है, जो ऐक्सेस अनुमतियां देने के लिए इस्तेमाल कर रहे हैं. ज़्यादा जानकारी के लिए, यहां देखें दस्तावेज़ में दिया गया है.

अपने क्रेडेंशियल की मदद से क्लाइंट लाइब्रेरी कॉन्फ़िगर करना

क्लाइंट लाइब्रेरी को किसी कॉन्फ़िगरेशन फ़ाइल के साथ कॉन्फ़िगर किया जा सकता है, एनवायरमेंट वैरिएबल या प्रोग्राम के हिसाब से. इस गाइड के लिए, हम डेस्कटॉप और वेब फ़्लो पर फ़ोकस करने के लिए बनाया गया है. इसका इस्तेमाल करके आम तौर पर, अगर आपके पास कॉन्फ़िगरेशन फ़ाइल का सिर्फ़ एक सेट है, तो क्रेडेंशियल. उदाहरण के लिए, एक ही मैनेजर खाते से खातों को मैनेज किया जा सकता है.

इस कॉन्टेंट के साथ ~/ads.properties फ़ाइल बनाएं:

api.googleads.clientId=INSERT_CLIENT_ID_HERE
api.googleads.clientSecret=INSERT_CLIENT_SECRET_HERE
api.googleads.refreshToken=INSERT_REFRESH_TOKEN_HERE
api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE

प्लेसहोल्डर को पिछले चरण में मिले क्रेडेंशियल से बदलें.

इसके अलावा, अगर आपका रीफ़्रेश टोकन किसी मैनेजर खाते के लिए है, तो आपको प्रवेश ग्राहक के रूप में इस खाते का ग्राहक आईडी दर्ज करें:

api.googleads.loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE

क्रेडेंशियल की पुष्टि करें

यह पक्का करने के लिए कि सब कुछ सही तरीके से सेटअप हो, हम Get campaigns उदाहरण के लिए.

सबसे पहले, 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'