OAuth सेटअप करना

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

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

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

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

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

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

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

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

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

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

अपने प्रोजेक्ट के लिए कोई एपीआई चालू करने के लिए:

  1. Google API Console में एपीआई लाइब्रेरी खोलें.
  2. अगर कहा जाए, तो कोई प्रोजेक्ट चुनें या नया प्रोजेक्ट बनाएं. एपीआई लाइब्रेरी में, उपलब्ध सभी एपीआई की सूची दी गई है. इन्हें प्रॉडक्ट फ़ैमिली और लोकप्रियता के हिसाब से ग्रुप किया गया है.
  3. अगर आपको जिस एपीआई को चालू करना है वह सूची में नहीं दिख रहा है, तो उसे खोजने के लिए खोज बार का इस्तेमाल करें. इसके अलावा, उस एपीआई से जुड़े प्रॉडक्ट फ़ैमिली में जाकर सभी देखें पर क्लिक करें.
  4. वह एपीआई चुनें जिसे आपको चालू करना है. इसके बाद, चालू करें बटन पर क्लिक करें.
  5. अगर कहा जाए, तो बिलिंग चालू करें.
  6. प्रॉम्प्ट मिलने पर, एपीआई की सेवा की शर्तें पढ़ें और उन्हें स्वीकार करें.

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

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

  1. क्लाइंट पेज पर जाएं.

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

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

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

    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 का इस्तेमाल करके, वेब ऐप्लिकेशन के टोकन रद्द किए जा सकते हैं.