Google API Console प्रोजेक्ट को बनाने और कॉन्फ़िगर करने का तरीका, आपके ऐप्लिकेशन के OAuth 2.0 ऑथराइज़ेशन के तरीके पर निर्भर करता है. इस गाइड को अपनी ज़रूरत के मुताबिक बनाने के लिए, अनुमति देने का कोई तरीका चुनें.
OAuth 2.0 क्रेडेंशियल बनाने और अपने ऐप्लिकेशन के लिए Google Ads API चालू करने के लिए, आपको Google API Console प्रोजेक्ट की ज़रूरत होगी.
ये क्रेडेंशियल, Google के सर्वर पर आपके ऐप्लिकेशन या Google Ads के उपयोगकर्ताओं की पुष्टि करते हैं और उन्हें अनुमति देते हैं. साथ ही, इनकी मदद से OAuth टोकन जनरेट किए जा सकते हैं, ताकि एपीआई को कॉल करने के लिए उनका इस्तेमाल किया जा सके.
कोई Google API Console प्रोजेक्ट चुनें या नया बनाएं
नया प्रोजेक्ट सेट अप करने के लिए, Google API Console प्रोजेक्ट बनाने से जुड़ी गाइड पढ़ें. अपने प्रोजेक्ट के लिए बिलिंग की सुविधा चालू करना ज़रूरी नहीं है. अगर आपने बिलिंग की सुविधा चालू की है, तो नए प्रोजेक्ट के लिए बिलिंग खाता चुनें. Google Ads API का इस्तेमाल करने के लिए, कोई शुल्क नहीं लिया जाता. हालांकि, Cloud प्रोजेक्ट पर प्रोजेक्ट के कोटे की स्टैंडर्ड सीमाएं लागू होती हैं.
अपने प्रोजेक्ट में Google Ads API चालू करना
अपने प्रोजेक्ट में Google Ads API को चालू करने के लिए, यह तरीका अपनाएं:
Google API Console में एपीआई लाइब्रेरी खोलें. अगर कहा जाए, तो अपना प्रोजेक्ट चुनें या नया प्रोजेक्ट बनाएं. एपीआई लाइब्रेरी में, उपलब्ध सभी एपीआई की सूची होती है. इन्हें प्रॉडक्ट फ़ैमिली और लोकप्रियता के हिसाब से ग्रुप में बांटा जाता है.
अगर आपको सूची में Google Ads API नहीं दिख रहा है, तो उसे खोजने के लिए खोज बार का इस्तेमाल करें.
Google Ads API को चुनें. इसके बाद, चालू करें बटन पर क्लिक करें.
एपीआई के ऐक्सेस के लिए आवेदन करना
इसके बाद, Google Ads API के होम पेज पर जाएं और देखें कि आपका मौजूदा एपीआई ऐक्सेस लेवल क्या है. अगर आपका मौजूदा एपीआई ऐक्सेस लेवल टेस्ट है, तो ऐक्सेस लेवल अपग्रेड करें सेक्शन को बड़ा करें. एक्सप्लोरर ऐक्सेस लेवल के लिए आवेदन करने के लिए, निर्देशों का पालन करें.
आवेदन पूरा करने के बाद, Google आपके आवेदन की अपने-आप समीक्षा करता है. साथ ही, ज़्यादातर मामलों में इसे एक्सप्लोरर ऐक्सेस में अपग्रेड कर देता है.
OAuth के लिए सहमति की स्क्रीन को कॉन्फ़िगर करना
अनुमति देने के लिए OAuth 2.0 का इस्तेमाल करने पर, Google उपयोगकर्ता को सहमति वाली स्क्रीन दिखाता है. इसमें आपके प्रोजेक्ट की खास जानकारी, उसकी नीतियां, और ऐक्सेस के लिए अनुमति देने के अनुरोध किए गए दायरे शामिल होते हैं. अपने ऐप्लिकेशन के लिए, OAuth के लिए सहमति की स्क्रीन को कॉन्फ़िगर करने से यह तय होता है कि उपयोगकर्ताओं और ऐप्लिकेशन की समीक्षा करने वालों को क्या दिखेगा. साथ ही, इससे आपका ऐप्लिकेशन रजिस्टर हो जाता है, ताकि बाद में उसे पब्लिश किया जा सके.
अपने ऐप्लिकेशन के लिए, OAuth के लिए सहमति वाली स्क्रीन कॉन्फ़िगर करें और OAuth के दायरे के तौर पर https://www.googleapis.com/auth/adwords को जोड़ें.
उपयोगकर्ता के टाइप और पब्लिश करने की स्थिति के बारे में ज़रूरी बातें
OAuth के लिए सहमति देने वाली स्क्रीन को कॉन्फ़िगर करते समय, उपयोगकर्ता टाइप और पब्लिश करने की स्थिति सेटिंग पर ध्यान दें.
- उपयोगकर्ता का टाइप: इससे यह तय होता है कि आपका ऐप्लिकेशन सिर्फ़ आपके संगठन के उपयोगकर्ताओं (इंटरनल) के लिए उपलब्ध है या Google का इस्तेमाल करने वाले किसी भी व्यक्ति (एक्सटर्नल) के लिए उपलब्ध है. इंटरनल विकल्प सिर्फ़ तब उपलब्ध होता है, जब आपका प्रोजेक्ट Google Workspace संगठन का हिस्सा हो.
- पब्लिश करने का स्टेटस:इससे यह तय होता है कि ऐप्लिकेशन टेस्टिंग मोड में है या प्रोडक्शन मोड में है. टेस्टिंग मोड में, ऐप्लिकेशन सिर्फ़ उन टेस्टर के लिए उपलब्ध होता है जिन्हें आपने जोड़ा है. प्रोडक्शन मोड में, ऐप्लिकेशन उपयोगकर्ता टाइप के हिसाब से तय की गई ऑडियंस के लिए उपलब्ध होता है. इसके लिए, Google से ऐप्लिकेशन की पुष्टि कराना ज़रूरी हो सकता है.
अपने ऐप्लिकेशन के लिए सबसे सही विकल्प चुनने के लिए, Google Cloud के आधिकारिक सहायता दस्तावेज़ में इन सेटिंग के बारे में ज़्यादा जानकारी और इनके असर के बारे में पढ़ें:
- OAuth की सहमति वाली स्क्रीन पर उपयोगकर्ता टाइप के विकल्प
- OAuth के लिए सहमति लेने वाली स्क्रीन के पब्लिशिंग स्टेटस के
इन सेटिंग को समझना ज़रूरी है, ताकि यह पक्का किया जा सके कि आपका ऐप्लिकेशन, आपके टारगेट किए गए उपयोगकर्ताओं के लिए उपलब्ध हो.
क्लाइंट आईडी और क्लाइंट सीक्रेट बनाना
क्लाइंट आईडी और क्लाइंट सीक्रेट बनाएं. ऐप्लिकेशन के टाइप के तौर पर, डेस्कटॉप ऐप्लिकेशन या वेब ऐप्लिकेशन में से कोई एक विकल्प चुना जा सकता है. OAuth 2.0 क्लाइंट बनाने के बाद, पुष्टि करने वाले डायलॉग बॉक्स में JSON डाउनलोड करें बटन पर क्लिक करके, क्लाइंट की JSON फ़ाइल डाउनलोड करें.