Google Ads API के लिए Google API (एपीआई) कंसोल प्रोजेक्ट कॉन्फ़िगर करना

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

Cloud प्रोजेक्ट से जुड़े कुछ सबसे सही तरीके जानने के लिए यह वीडियो देखें

Google OAuth से पुष्टि

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

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

Google से पुष्टि कराने के लिए, कोई शुल्क नहीं लिया जाता. यह पुष्टि, आम तौर पर तीन से पांच कामकाजी दिनों में पूरी हो जाती है. यह नीति सभी ऐप्लिकेशन पर लागू होती है.

हमारा सुझाव है कि कारोबार में किसी तरह की रुकावट से बचने के लिए, सभी ऐप्लिकेशन को जल्द से जल्द Google OAuth की पुष्टि की प्रक्रिया से गुज़रना चाहिए.

प्रोजेक्ट बनाना

Google के एपीआई कंसोल पर जाएं. प्रोजेक्ट बनाएं पर क्लिक करें, कोई नाम डालें, और बनाएं पर क्लिक करें.

अहम जानकारी: अगर आपने Google Cloud के लिए बिलिंग की सुविधा चालू की है, तो आपको नए प्रोजेक्ट के लिए कोई बिलिंग खाता चुनना होगा.

Google Ads API का इस्तेमाल करने के लिए कोई शुल्क नहीं लिया जाता. हालांकि, Cloud प्रोजेक्ट की कुल संख्या के लिए कोटा होता है. इसके अलावा, एक नए Google खाते के लिए साइन अप किया जा सकता है. इसमें प्रोजेक्ट जोड़ने के लिए कोटा मुफ़्त है.

अपने प्रोजेक्ट में Google Ads API चालू करना

अपने प्रोजेक्ट के लिए Google Ads API चालू करने के लिए, यह तरीका अपनाएं:

1. Google API कंसोल में एपीआई लाइब्रेरी खोलें. अगर कहा जाए, तो अपना प्रोजेक्ट चुनें या नया प्रोजेक्ट बनाएं. एपीआई लाइब्रेरी में, सभी उपलब्ध एपीआई की सूची होती है. इन्हें प्रॉडक्ट फ़ैमिली और लोकप्रियता के हिसाब से ग्रुप में बांटा जाता है.

2. अगर सूची में Google Ads API नहीं दिख रहा है, तो उसे खोजने के लिए खोज का इस्तेमाल करें.

3. Google Ads API चुनें. इसके बाद, चालू करें बटन पर क्लिक करें.

उपयोगकर्ता का टाइप और पब्लिश करने की स्थिति चुनें

एपीआई चालू करने के बाद, आपको अपने प्रोजेक्ट का उपयोगकर्ता टाइप और पब्लिश करने की स्थिति बतानी होगी. नीचे दी गई टेबल में, इन सेटिंग के हर कॉम्बिनेशन की कुछ मुख्य एट्रिब्यूट और उनकी सीमाओं को हाइलाइट किया गया है. ज़्यादा जानकारी के लिए, Google Cloud Platform के दस्तावेज़ देखें.

उपयोगकर्ता प्रकार	प्रकाशन की स्थिति	सीमाएं
वह व्यू जो Google में काम करने वाले व्यक्ति को दिखेगा	टेस्ट करना	यह सुविधा सिर्फ़ Google Cloud संगठन से जुड़े प्रोजेक्ट के लिए उपलब्ध है. स्क्रीन पर OAuth के लिए सहमति देने वाली स्क्रीन पर, टेस्ट के लिए ज़्यादा से ज़्यादा 100 उपयोगकर्ता शामिल किए जा सकते हैं. टेस्ट उपयोगकर्ता, प्रोजेक्ट से जुड़े 'Google क्लाउड' संगठन के अंदरूनी उपयोगकर्ता होने चाहिए. अनुमति देने की समयसीमा, सहमति देने के सात दिन बाद खत्म हो जाती है.
बाहरी सोर्स	टेस्ट करना	सभी प्रोजेक्ट के लिए उपलब्ध. स्क्रीन पर OAuth के लिए सहमति देने वाली स्क्रीन पर, टेस्ट के लिए ज़्यादा से ज़्यादा 100 उपयोगकर्ता शामिल किए जा सकते हैं. टेस्ट यूज़र, Google खाता रखने वाला कोई भी उपयोगकर्ता हो सकता है. अनुमति देने की समयसीमा, सहमति देने के सात दिन बाद खत्म हो जाती है.
वह व्यू जो Google में काम करने वाले व्यक्ति को दिखेगा	प्रोडक्शन में	यह सुविधा सिर्फ़ Google Cloud संगठन से जुड़े प्रोजेक्ट के लिए उपलब्ध है. प्रोजेक्ट से जुड़े 'Google क्लाउड' संगठन में किसी भी उपयोगकर्ता को अनुमति देने की अनुमति देता है.
बाहरी सोर्स	प्रोडक्शन में	सभी प्रोजेक्ट के लिए उपलब्ध. Google खाते वाले किसी भी उपयोगकर्ता को अनुमति देने देता है.

अगर आपके प्रोजेक्ट का उपयोगकर्ता टाइप या पब्लिश करने की स्थिति कुछ भी हो, तो इन चीज़ों के लिए, Google OAuth की पुष्टि नहीं करने पर ये नतीजे मिलेंगे:

• अनुमति देने की प्रक्रिया के दौरान, उपयोगकर्ताओं को पुष्टि नहीं हुई यूज़र इंटरफ़ेस (यूआई) स्क्रीन दिखाई जाती है.

• आप सिर्फ़ 100 उपयोगकर्ताओं को अनुमति दे सकते हैं.

उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth के लिए सहमति दी जाती है

1. सहमति स्क्रीन वाला पेज खोलें और पेज के सबसे ऊपर मौजूद ड्रॉपडाउन मेन्यू में जाकर, अपना प्रोजेक्ट चुनें.

2. उपयोगकर्ता टाइप चुनें और बनाएं पर क्लिक करें.

3. सहमति वाली स्क्रीन का फ़ॉर्म भरें. ज़रूरत पड़ने पर, इसमें बाद में बदलाव किया जा सकता है. काम पूरा हो जाने पर, सेव करें और जारी रखें पर क्लिक करें.

4. अगले पेज पर, स्कोप जोड़ें या हटाएं पर क्लिक करें.

   • नीचे की ओर स्क्रोल करें और मैन्युअल तरीके से दायरा जोड़ें फ़ील्ड में यह जानकारी डालें:

     https://www.googleapis.com/auth/adwords
     

   • टेबल में जोड़ें पर क्लिक करें.

   • अपने प्रोजेक्ट के लिए अनुरोध किया जाने वाला कोई अन्य स्कोप जोड़ें. इसके बाद, अपडेट करें पर क्लिक करें.

   • सहेजें और जारी रखें पर क्लिक करें.

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

6. खास जानकारी वाले पेज की समीक्षा करें और डैशबोर्ड पर वापस जाएं पर क्लिक करें.

अपने ऐप्लिकेशन और अनुमति देने की प्रक्रिया की जांच करने के बाद, डैशबोर्ड पर वापस जाकर ऐप्लिकेशन पब्लिश करें पर क्लिक करके, उसकी पब्लिश करने की स्थिति को टेस्टिंग से प्रोडक्शन में है में बदला जा सकता है.

ऐप्लिकेशन का टाइप चुनें

Google Ads API के लिए, ऐप्लिकेशन टाइप के दो विकल्प उपलब्ध हैं: डेस्कटॉप या वेब. यहां दी गई टेबल देखकर पता लगाएं कि आपको जिस ऐप्लिकेशन को बनाना है उसके लिए कौनसा टाइप सबसे सही है:

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

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

ज़्यादा जानकारी के लिए, डेस्कटॉप ऐप्लिकेशन या वेब ऐप्लिकेशन के लिए, Google Identity Platform का OAuth दस्तावेज़ देखें.

क्लाइंट आईडी और क्लाइंट सीक्रेट बनाना

अपने ऐप्लिकेशन का टाइप तय करने के बाद, OAuth2 क्लाइंट आईडी और क्लाइंट सीक्रेट जनरेट करने के लिए, नीचे दिए गए निर्देशों का पालन करें:

1. क्रेडेंशियल पेज खोलें. पहले से बनाया गया कोई प्रोजेक्ट चुनें या नया प्रोजेक्ट बनाएं.

2. क्रेडेंशियल वाली स्क्रीन पर, क्रेडेंशियल बनाएं पर क्लिक करें. इसके बाद, OAuth का इस्तेमाल करने के लिए क्लाइंट आईडी चुनें.

   1. अगर आपने पहले इस प्रोजेक्ट के लिए, ऐसी स्क्रीन कॉन्फ़िगर नहीं की थी जहां OAuth के लिए सहमति दी जाती है, तो अब आपको ऐसा करने के लिए कहा जाएगा. सहमति स्क्रीन कॉन्फ़िगर करें पर क्लिक करें.

      1. उपयोगकर्ता का टाइप चुनें और बनाएं पर क्लिक करें.

      2. शुरुआती फ़ॉर्म भरें. ज़रूरत पड़ने पर, इसमें बाद में बदलाव किया जा सकता है. बदलाव करने के बाद, सेव करें पर क्लिक करें.

   2. जारी रखने के लिए, क्रेडेंशियल > क्रेडेंशियल बनाएं > OAuth क्लाइंट आईडी पर वापस जाएं.

3. इस्तेमाल के उदाहरण के हिसाब से, ऐप्लिकेशन के टाइप के तौर पर डेस्कटॉप ऐप्लिकेशन या वेब ऐप्लिकेशन चुनें.

4. इसे एक नाम दें, फिर बनाएं पर क्लिक करें.

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

   हमारी क्लाइंट लाइब्रेरी के उदाहरणों में मौजूद डिफ़ॉल्ट कॉन्फ़िगरेशन के साथ काम करने वाले लोकल टेस्टिंग के लिए, http://127.0.0.1 का इस्तेमाल करें.

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

   डेस्कटॉप ऐप्लिकेशन क्लाइंट के लिए, आपको अब भी लूपबैक आईपी रीडायरेक्ट का इस्तेमाल करना होगा. हालांकि, यूआरआई को Cloud Console में साफ़ तौर पर कॉन्फ़िगर नहीं किया गया है.

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