प्रमाणीकरण

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

OAuth2 क्रेडेंशियल जनरेट करें

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

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

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

OAuth2 की पुष्टि करने का तरीका चुनना
सेवा खाता

अगर आपको सिर्फ़ अपने Ad Manager डेटा का ऐक्सेस चाहिए, तो यह विकल्प चुनें.

ज़्यादा जानें.
वेब ऐप्लिकेशन

अगर आपको किसी ऐसे उपयोगकर्ता के तौर पर पुष्टि करनी है जो आपके ऐप्लिकेशन को Ad Manager के डेटा को ऐक्सेस करने की अनुमति देता है, तो इसे चुनें.

ज़्यादा जानें.

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

पुष्टि करने का तरीका तय करने के बाद, नीचे दिए गए टैब पर क्लिक करें और OAuth2 क्रेडेंशियल जनरेट करने के लिए दिए गए निर्देशों का पालन करें:

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

3. अपना Ad Manager नेटवर्क कॉन्फ़िगर करना

अगर आप तीसरे पक्ष के डेवलपर हैं, तो आपको अपने क्लाइंट से यह चरण पूरा करने के लिए कहना पड़ सकता है.

सेवा खाता
  1. अपने Ad Manager नेटवर्क पर जाएं.
  2. एडमिन टैब पर क्लिक करें.
  3. पक्का करें कि एपीआई ऐक्सेस चालू है.
  4. सेवा खाते का उपयोगकर्ता जोड़ें बटन पर क्लिक करें.
  5. सेवा खाते के ईमेल पते का इस्तेमाल करके फ़ॉर्म भरें. सेवा खाते के उपयोगकर्ता को इकाइयों को ऐक्सेस करने की अनुमतियां मिलनी चाहिए, जैसे कि सेवा खाते का वह उपयोगकर्ता यूज़र इंटरफ़ेस पर मौजूद इकाइयों को ऐक्सेस करेगा.
  6. सेव करें बटन पर क्लिक करें. आपको एक मैसेज दिखेगा, जिसमें आपके सेवा खाते को जोड़े जाने की पुष्टि होगी.
  7. सेवा खाते के मौजूदा उपयोगकर्ताओं को देखने के लिए, 'उपयोगकर्ता' टैब पर जाएं. इसके बाद, सेवा खाता फ़िल्टर पर क्लिक करें.
वेब ऐप्लिकेशन
  1. अपने Ad Manager नेटवर्क पर जाएं.
  2. एडमिन टैब पर क्लिक करें.
  3. पक्का करें कि एपीआई ऐक्सेस चालू है.

4. क्लाइंट लाइब्रेरी को कॉन्फ़िगर करना और उसका इस्तेमाल करना

अपनी क्लाइंट लाइब्रेरी में क्रेडेंशियल का इस्तेमाल करने के लिए, नीचे दी गई सही गाइड का पालन करें:

अगर आपको हमारी किसी क्लाइंट लाइब्रेरी का इस्तेमाल नहीं करना है, तो आपको OAuth2 सेवा खाता या वेब ऐप्लिकेशन फ़्लो खुद लागू करना होगा.

पर्दे के पीछे की गतिविधियों वाले वीडियो

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

एचटीटीपी अनुरोध का हेडर

Ad Manager API से किए गए हर अनुरोध में मौजूद एचटीटीपी हेडर में इस फ़ॉर्म में एक ऐक्सेस टोकन शामिल होना चाहिए:

Authorization: Bearer ACCESS_TOKEN

उदाहरण के लिए:

POST … HTTP/1.1
Host: …
Authorization: Bearer 1/fFAGRNJru1FTz70BzhT3Zg
Content-Type: text/xml;charset=UTF-8
Content-Length: …

<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope">
…
</soap:Envelope>

स्कोप

एक ऐक्सेस टोकन, कई एपीआई को अलग-अलग लेवल का ऐक्सेस दे सकता है. scope नाम का वैरिएबल पैरामीटर उन संसाधनों और ऑपरेशन के सेट को कंट्रोल करता है जिन्हें ऐक्सेस टोकन अनुमति देता है. ऐक्सेस टोकन के अनुरोध के दौरान, आपका ऐप्लिकेशन scope पैरामीटर में एक या उससे ज़्यादा वैल्यू भेजता है.

Ad Manager में सिर्फ़ एक स्कोप है, जिसे नीचे दिखाया गया है. प्रॉडक्ट में उपयोगकर्ता के स्तर पर अनुमति दी जानी चाहिए.

स्कोप अनुमतियां
https://www.googleapis.com/auth/dfp Ad Manager पर अपने कैंपेन देखें और मैनेज करें.