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 का इस्तेमाल करने के लिए कोई शुल्क नहीं लिया जाता. हालांकि, क्लाउड प्रोजेक्ट पर स्टैंडर्ड प्रोजेक्ट कोटा की सीमाएं लागू होती हैं.
अपने प्रोजेक्ट में 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 फ़ाइल डाउनलोड करें.