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