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 खाते का डेटा ऐक्सेस करने की अनुमति दे सकता है. आपको अनुमति देने वाले कई क्रेडेंशियल आसानी से जनरेट करने हों, ताकि उदाहरण के लिए, तीसरे पक्ष के खातों को मैनेज किया जा सके. आपके ऐप्लिकेशन के लिए कॉलबैक यूआरएल ज़रूरी हैं. कॉलबैक यूआरएल, डेस्कटॉप ऐप्लिकेशन फ़्लो में काम नहीं करते.

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

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