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

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

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

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

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

यह पता करना कि आपने किस तरह की पुष्टि की है

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

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

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

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

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

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

अपने प्रोजेक्ट के लिए API सक्षम करने के लिए:

  1. Open the API Library में Google API Console
  2. If prompted, select a project, or create a new one. API Library सभी उपलब्ध API को सूचीबद्ध करता है, जो उत्पाद परिवार और लोकप्रियता द्वारा समूहीकृत है।
  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. बनाएं CREDENTIALS > 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 का इस्तेमाल करके, वेब ऐप्लिकेशन टोकन को निरस्त किया जा सकता है.