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