AdMob API का इस्तेमाल शुरू करना

अहम जानकारी: उपयोगकर्ता की नई भूमिकाओं और अनुमतियों का, AdMob API से मिले डेटा पर असर पड़ेगा. ज़्यादा जानें

यह गाइड उन डेवलपर के लिए है जो अपने AdMob खाते में प्रोग्राम के हिसाब से डेटा मैनेज करने के लिए, AdMob API का इस्तेमाल करना चाहते हैं.

सभी Google AdMob API कॉल को OAuth2 की मदद से अनुमति दी जानी चाहिए, ताकि आपका ऐप्लिकेशन उपयोगकर्ता की ओर से वेब सेवाओं से इंटरैक्ट कर सके. OAuth2 की मदद से, आपके AdMob API क्लाइंट ऐप्लिकेशन को उपयोगकर्ता के AdMob खाते को ऐक्सेस करने की अनुमति मिलती है. इसके लिए, उपयोगकर्ता के उपयोगकर्ता नाम या पासवर्ड को मैनेज या सेव करने की ज़रूरत नहीं होती. अनुमति देने की खास जानकारी के लिए, अनुमति देना देखें.

OAuth2 क्रेडेंशियल जनरेट करने और अपना पहला अनुरोध करने के लिए, यहां दिया गया तरीका अपनाएं.

ज़रूरी शर्तें

• एक Google खाता.

• Google AdMob खाता.

• REST की बुनियादी बातों और OAuth 2.0 की मदद से अनुरोधों को अनुमति देने के बारे में जानकारी.

पुष्टि करने का तरीका तय करना

नीचे दी गई टेबल में देखें कि आपके ऐप्लिकेशन के लिए, पुष्टि करने का कौनसा तरीका सबसे सही है:

OAuth2 की मदद से पुष्टि करने का तरीका चुनना	अगर ...
डेस्कटॉप ऐप्लिकेशन	आपने एक ही टॉप लेवल मैनेजर खाते का इस्तेमाल करके, अपने सभी AdMob API खाते मैनेज किए हों. आपने पहली बार इस्तेमाल किया है या आपको सबसे आसान सेटअप के साथ तुरंत शुरू करना है. आपका ऐप्लिकेशन, Google AdMob के उपयोगकर्ताओं की पुष्टि सिर्फ़ एक मशीन से करता है.
वेब ऐप्लिकेशन	आपको एक ऐसे उपयोगकर्ता के तौर पर पुष्टि करनी हो जो आपके ऐप्लिकेशन को उनके AdMob API खाते के डेटा को ऐक्सेस करने की अनुमति दे सके. आपको अनुमति देने वाले कई क्रेडेंशियल आसानी से जनरेट करने हों, ताकि उदाहरण के लिए, तीसरे पक्ष के खातों को मैनेज किया जा सके. आपके ऐप्लिकेशन के लिए कॉलबैक यूआरएल ज़रूरी हैं. कॉलबैक यूआरएल, डेस्कटॉप ऐप्लिकेशन फ़्लो में काम नहीं करते.

अहम जानकारी: सर्वर पर चलने वाले ऐप्लिकेशन को डेवलप करने के बावजूद, डेस्कटॉप ऐप्लिकेशन फ़्लो को चुना जा सकता है. अंतर यह है कि OAuth अनुमति, स्थानीय तौर पर या रिमोट तौर पर पूरी की गई है. डेस्कटॉप फ़्लो के लिए, लोकल मशीन पर ऑथराइज़ेशन को पूरा करना ज़रूरी होता है, जबकि वेब-फ़्लो, Google के ऑथराइज़ेशन सर्वर पर पुष्टि करने की प्रोसेस को पूरा करता है.

प्रोजेक्ट बनाना

AdMob API का इस्तेमाल शुरू करने के लिए, आपको पहले Google API Console में कोई प्रोजेक्ट बनाना या चुनना होगा. इसके बाद, सेटअप टूल का इस्तेमाल करके एपीआई को चालू करना होगा. यह टूल, आपको प्रोसेस के बारे में जानकारी देता है और AdMob API को अपने-आप चालू करता है.

किसी मौजूदा प्रोजेक्ट के लिए एपीआई चालू करना

यह तरीका उन उपयोगकर्ताओं के लिए है जिनके पास कोई मौजूदा प्रोजेक्ट है और वे इसके लिए AdMob API को मैन्युअल तरीके से चालू करना चाहते हैं.

OAuth2 क्रेडेंशियल बनाएं

इंस्टॉल किए गए ऐप्लिकेशन के फ़्लो के साथ इस्तेमाल करने के लिए, OAuth 2.0 क्लाइंट आईडी बनाने का तरीका नीचे दिया गया है.

2. क्रेडेंशियल बनाएं > OAuth क्लाइंट आईडी पर क्लिक करें.

   अगर आपने पहले इस प्रोजेक्ट के लिए ऐसी स्क्रीन कॉन्फ़िगर नहीं की थी जहां OAuth के लिए सहमति दी जाती है, तो अब आपको ऐसा करने के लिए कहा जाएगा. सहमति वाली स्क्रीन कॉन्फ़िगर करें पर क्लिक करें. OAuth 2.0 क्लाइंट आईडी का इस्तेमाल करने के लिए, सहमति वाली स्क्रीन को कॉन्फ़िगर करने के कई तरीके हैं.

   1. उपयोगकर्ता टाइप को बाहरी और पब्लिश करने की स्थिति को पब्लिश किया गया पर सेट करें.

   2. इसके अलावा, उपयोगकर्ता टाइप को बाहरी और पब्लिश करने की स्थिति को टेस्टिंग पर सेट करें. इसके बाद, उपयोगकर्ता जोड़ें को चुनकर टेस्ट उपयोगकर्ता जोड़ें, ताकि उन्हें आपके OAuth 2.0 क्लाइंट आईडी का इस्तेमाल करने का ऐक्सेस दिया जा सके.

      OAuth की सहमति वाली स्क्रीन सेट अप करने के बारे में ज़्यादा जानकारी देखें.

3. ऐप्लिकेशन के टाइप के तौर पर डेस्कटॉप ऐप्लिकेशन या वेब ऐप्लिकेशन चुनें, उसे एक नाम दें और बनाएं पर क्लिक करें.

इसके बाद, आपको OAuth 2.0 क्लाइंट आईडी और क्लाइंट पासवर्ड दिखेगा. इसे JSON फ़ॉर्मैट में डाउनलोड करके, बाद में इस्तेमाल के लिए सेव किया जा सकता है.

अनुरोध करें

AdMob API को एचटीटीपी और JSON पर बनाया गया है. इसलिए, कोई भी स्टैंडर्ड एचटीटीपी क्लाइंट इसके लिए अनुरोध भेज सकता है और जवाबों को पार्स कर सकता है. हालांकि, Google API क्लाइंट लाइब्रेरी में भाषा का बेहतर इंटिग्रेशन, बेहतर सुरक्षा, और अनुमति वाले अनुरोध करने के लिए सहायता मिलती है. क्लाइंट लाइब्रेरी कई प्रोग्रामिंग भाषाओं में उपलब्ध हैं. इनका इस्तेमाल करके, एचटीटीपी अनुरोधों को मैन्युअल तरीके से सेट अप करने और जवाबों को पार्स करने से बचा जा सकता है.

ध्यान दें: पहली बार OAuth फ़्लो को चालू करने पर, आपसे AdMob पब्लिशर आईडी देने और ब्राउज़र में अनुमति देने के अनुरोध को स्वीकार करने के लिए कहा जाता है. स्वीकार करने से पहले, पक्का करें कि आपने उस Google खाते से साइन इन किया हो जिसके पास आपके AdMob खाते का ऐक्सेस है. इसके बाद, आपके ऐप्लिकेशन को उस खाते से डेटा ऐक्सेस करने की अनुमति मिल जाती है जिसमें फ़िलहाल लॉग इन किया गया है.

OAuth 2.0 क्रेडेंशियल बनाने के बाद, AdMob API का इस्तेमाल शुरू किया जा सकता है. OAuth 2.0 का इस्तेमाल करके डेटा ऐक्सेस करने का अनुरोध करने के लिए, आपके ऐप्लिकेशन को दायरे की जानकारी भी देनी होगी:

दायरा	मतलब
https://www.googleapis.com/auth/admob.readonly	AdMob का पूरा डेटा देखें. इसमें खाते की जानकारी, इन्वेंट्री और मीडिएशन सेटिंग, रिपोर्ट, और अन्य डेटा शामिल हो सकता है. उस डेटा में, पैसे चुकाने या कैंपेन के ब्यौरे जैसी संवेदनशील जानकारी शामिल नहीं होती.
https://www.googleapis.com/auth/admob.report	विज्ञापन की परफ़ॉर्मेंस और आय की रिपोर्ट देखें. पब्लिशर आईडी, टाइमज़ोन, और डिफ़ॉल्ट मुद्रा कोड देखें.

Java, PHP, Python या curl के उदाहरणों का इस्तेमाल करके, रिपोर्ट जनरेट करने का पहला अनुरोध करें.

शेयर किए गए टोकन रद्द करना

शेयर किए गए टोकन दो तरीकों से रद्द किए जा सकते हैं:

1. अपने Google खाते की अनुमतियों वाले पेज पर जाएं और उससे जुड़े प्रोजेक्ट का ऐक्सेस वापस लें.

2. इसके अलावा, Google Identity API का इस्तेमाल करके, वेब ऐप्लिकेशन टोकन रद्द किए जा सकते हैं.