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 कंसोल में एक प्रोजेक्ट बनाना या चुनना होगा. इसके बाद, सेटअप टूल का इस्तेमाल करके एपीआई चालू करना होगा. इससे आपको इस प्रोसेस में मदद मिलेगी और 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. 如果您要启用的API在列表中不可见，请使用搜索找到它，或单击其所属产品系列中的“ 查看全部 ”。
4. 选择要启用的API，然后单击“ 启用”按钮。
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 फ़्लो को चालू करने पर, आपसे अपना 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 का इस्तेमाल करके, वेब ऐप्लिकेशन टोकन को निरस्त किया जा सकता है.