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 Cloud संगठन में अंदरूनी उपयोगकर्ता होने चाहिए. अनुमतियों की समयसीमा, सहमति देने के सात दिन बाद खत्म हो जाती है.
बाहरी सोर्स	टेस्ट करना	सभी प्रोजेक्ट के लिए उपलब्ध है. OAuth के लिए सहमति देने वाली स्क्रीन में, जांच के लिए ज़्यादा से ज़्यादा 100 उपयोगकर्ताओं को शामिल किया जा सकता है. टेस्ट उपयोगकर्ता, Google खाते वाला कोई भी उपयोगकर्ता हो सकता है. अनुमतियों की समयसीमा, सहमति देने के सात दिन बाद खत्म हो जाती है.
वह व्यू जो Google में काम करने वाले व्यक्ति को दिखेगा	प्रोडक्शन में	सिर्फ़ Google Cloud संगठन से जुड़े प्रोजेक्ट के लिए उपलब्ध है. यह प्रोजेक्ट से जुड़े Google Cloud संगठन के किसी भी उपयोगकर्ता को अनुमति देता है.
बाहरी सोर्स	प्रोडक्शन में	सभी प्रोजेक्ट के लिए उपलब्ध है. इसकी मदद से, किसी भी उपयोगकर्ता को 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. पुष्टि करने वाले पेज पर, आपका Client-ID और आपका क्लाइंट सीक्रेट क्लिपबोर्ड पर कॉपी करें. अपनी क्लाइंट लाइब्रेरी को कॉन्फ़िगर करते समय, आपको इनकी ज़रूरत पड़ेगी. यह जानकारी पाने के लिए, बाद में क्रेडेंशियल पेज पर वापस भी जा सकते हैं.