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

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

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. Open the API Library में Google API Console.
  2. If prompted, select a project, or create a new one. इसमें, API Library उपलब्ध सभी एपीआई की सूची दी गई है. इन्हें प्रॉडक्ट फ़ैमिली और लोकप्रियता के हिसाब से ग्रुप किया गया है.
  3. अगर आपको जिस एपीआई को चालू करना है वह सूची में नहीं दिख रहा है, तो उसे खोजने के लिए खोज बार का इस्तेमाल करें. इसके अलावा, उस प्रॉडक्ट फ़ैमिली में सभी देखें पर क्लिक करें जिससे वह एपीआई जुड़ा है.
  4. वह एपीआई चुनें जिसे आपको चालू करना है. इसके बाद, चालू करें बटन पर क्लिक करें.
  5. If prompted, enable billing.
  6. If prompted, read and accept the API's Terms of Service.

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

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

  1. Go to the Credentials page.

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