Google API Console प्रोजेक्ट बनाने और उसे कॉन्फ़िगर करने का तरीका, इस बात पर निर्भर करता है कि आपके ऐप्लिकेशन में OAuth 2.0 ऑथराइज़ेशन का कौनसी सुविधा इस्तेमाल की जा रही है. वह ऑथराइज़ेशन सुविधा चुनें जिसके लिए ऐप्लिकेशन बनाया जा रहा है. इस सुविधा के हिसाब से, यह गाइड कस्टमाइज़ की जाएगी.
OAuth 2.0 क्रेडेंशियल बनाने और अपने ऐप्लिकेशन के लिए Google Ads API की सुविधा चालू करने के लिए, आपके पास Google API Console प्रोजेक्ट होना चाहिए.
Google के सर्वर, Google Ads के उपयोगकर्ताओं की पुष्टि और उन्हें ऑथराइज़ करने के लिए क्रेडेंशियल का इस्तेमाल करते हैं. इन क्रेडेंशियल की मदद से, OAuth टोकन जनरेट किए जा सकते हैं. इनका इस्तेमाल एपीआई को कॉल करने के लिए किया जाता है.
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 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 के लिए सहमति की स्क्रीन पर दिखने वाले पब्लिशिंग की स्थिति के विकल्प
इन सेटिंग को समझना ज़रूरी है, ताकि यह पक्का किया जा सके कि आपका ऐप्लिकेशन, उन उपयोगकर्ताओं के लिए उपलब्ध हो जिनके लिए इसे बनाया गया है.
क्लाइंट आईडी और क्लाइंट सीक्रेट बनाना
अगर आपने Google API Console के किसी ऐसे मौजूदा प्रोजेक्ट का इस्तेमाल किया है जिसमें पहले से ही क्लाइंट आईडी और क्लाइंट सीक्रेट जनरेट किया गया है, तो इस चरण को छोड़ा जा सकता है. इसके अलावा, निर्देशों का पालन करके क्लाइंट आईडी और क्लाइंट सीक्रेट बनाएं . ऐप्लिकेशन के टाइप के तौर पर, डेस्कटॉप ऐप्लिकेशन या वेब ऐप्लिकेशन में से कोई एक विकल्प चुना जा सकता है. OAuth 2.0 क्लाइंट बनाने के बाद, क्लाइंट की JSON फ़ाइल डाउनलोड करें. इसके लिए, पहले उसके OAuth क्लाइंट डाउनलोड करें आइकॉन पर क्लिक करें. इसके बाद, अगली स्क्रीन पर मौजूद JSON डाउनलोड करें बटन पर क्लिक करें.