Display & Video 360 Seller API में शामिल होना
Display & Video 360 Seller API का इस्तेमाल शुरू करने के लिए, कुछ ज़रूरी चरण पूरे करने होते हैं. DV360 Seller API, अनुमति वाली सूची पर आधारित Google Cloud API है. यह पुष्टि करने और अनुमति देने के लिए, OAuth 2.0 का इस्तेमाल करता है.
अनुमति वाली सूची में शामिल करने की प्रोसेस को Display & Video 360 Seller API टीम मैनेज करती है.
शामिल होने का तरीका:
- https://console.cloud.google.com/ पर जाकर, Google खाते के लिए साइन अप करें.
- इस खाते का इस्तेमाल, आपके प्रोडक्शन क्लाइंट के लिए ऐक्सेस टोकन मैनेज करने के लिए किया जाएगा. निजी Gmail खाते का इस्तेमाल न करें.
- खाता, Google ग्रुप का हिस्सा नहीं होना चाहिए.
- अगर किसी मौजूदा Google Cloud प्रोजेक्ट का इस्तेमाल किया जा रहा है, तो: खाते के पास प्रोजेक्ट का एडमिन ऐक्सेस होना चाहिए.
- अपने खाते की जानकारी के साथ Google DV360 टीम से संपर्क करें, ताकि उसे अनुमति वाली सूची में जोड़ा जा सके.
- खाता चालू होने की पुष्टि करने वाले ईमेल का इंतज़ार करें.
- ज़रूरी नहीं और इससे कोई रुकावट नहीं आती:
https://www.googleapis.com/auth/doubleclickbidmanagerस्कोप को ऐक्सेस करने के लिए, अपने ऐप्लिकेशन के लिए OAuth की पुष्टि करने से जुड़ी समीक्षा का अनुरोध सबमिट करें. - Google Cloud Console में, एपीआई और सेवाएं > लाइब्रेरी > निजी पर जाएं. आपको अपने प्रोजेक्ट के लिए, DV360 Seller API उपलब्ध दिखना चाहिए.
- DV360 सेलर एपीआई चालू करें.
- एपीआई और सेवाएं > क्रेडेंशियल > क्रेडेंशियल बनाएं > सेवा खाता की पर जाएं. OAuth 2.0 सेवा खाते के दस्तावेज़ में दिए गए सेटअप निर्देशों का पालन करें.
सेवा खाता सेट अप करें:
ध्यान दें: हमें बताएं कि क्या आपको किसी मौजूदा सेवा खाते का फिर से इस्तेमाल करना है. जैसे, DV360 Reporting API के लिए इस्तेमाल किया गया खाता.Google Cloud API में पुष्टि करने और अनुमति देने की प्रोसेस (आम तौर पर इसे "पुष्टि" कहा जाता है) के लिए, सेवा खाते का इस्तेमाल किया जाता है. सेवा खाते की मदद से, आपका कोड सीधे तौर पर Cloud API को ऐप्लिकेशन क्रेडेंशियल भेज सकता है. सेवा खाते को उपयोगकर्ता खाते की तरह ही, ईमेल पते से दिखाया जाता है. हालांकि, उपयोगकर्ता खाते के उलट, सेवा खाता सिर्फ़ किसी ऐप्लिकेशन का होता है. इसका इस्तेमाल सिर्फ़ उस एपीआई को ऐक्सेस करने के लिए किया जा सकता है जिसके लिए इसे बनाया गया था. उदाहरण के तौर पर, हम Google Cloud Platform Console का इस्तेमाल करके सेवा खाते के क्रेडेंशियल बनाने का तरीका दिखाएंगे.
Google Cloud Console का इस्तेमाल करके
Google Cloud Console के एपीआई मैनेजर→क्रेडेंशियल पेज पर जाकर, "क्रेडेंशियल बनाएं→सेवा खाते की कुंजी" को चुनें.
इसके बाद, "सेवा खाता" ड्रॉप-डाउन से "नया सेवा खाता" चुनें.
इस सेवा खाते के लिए, "नाम" डालें. इस नाम का इस्तेमाल, आपके "सेवा खाते के आईडी" के डिफ़ॉल्ट नाम के तौर पर किया जाएगा. यह नाम, जनरेट किए गए सेवा खाते के आईडी पते में "@" के बाईं ओर दिखेगा. हालांकि, अगर चाहें, तो सेवा खाते के आईडी के इस नाम को बदला जा सकता है. ये नाम कुछ भी हो सकते हैं. यह ज़रूरी है कि आपको ये नाम याद रहें. हमारा सुझाव है कि "की टाइप" में, इस वैल्यू को "JSON" पर ही रहने दें. "बनाएं" पर क्लिक करें. इसके बाद, GCP Console एक JSON कुंजी (
.jsonटेक्स्ट फ़ाइल के तौर पर) जनरेट करेगा. साथ ही, आपको फ़ाइल को अपने कंप्यूटर पर डाउनलोड करने के लिए कहेगा और सेवा खाता बनाया गया डायलॉग बॉक्स दिखाएगा.
जनरेट की गई JSON कुंजी, इस सैंपल JSON कुंजी की तरह होगी:
{ "type": "service_account", "project_id": "project-id", "private_key_id": "some_number", "private_key": "-----BEGIN PRIVATE KEY-----\n.... =\n-----END PRIVATE KEY-----\n", "client_email": "<api-name>api@project-id.iam.gserviceaccount.com", "client_id": "...", "auth_uri": "https://accounts.google.com/o/oauth2/auth", "token_uri": "https://accounts.google.com/o/oauth2/token", "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs", "client_x509_cert_url": "https://www.googleapis.com/...<api-name>api%40project-id.iam.gserviceaccount.com" }
इस JSON फ़ाइल को सुरक्षित रूप से सेव करें, क्योंकि इसमें आपकी निजी कुंजी मौजूद होती है. साथ ही, यह फ़ाइल उस कुंजी की एकमात्र कॉपी होती है. जब आपको Google Cloud Platform API को क्रेडेंशियल भेजने हों, तब आपको अपने कोड में इस सेवा खाते की कुंजी वाली फ़ाइल का रेफ़रंस देना होगा.
- DV360 टीम से संपर्क करें. इसके लिए, आपने जो सेवा खाता बनाया है उसकी जानकारी दें. खास तौर पर, सेवा खाते का ईमेल पता दें. यह अनुमति वाली सूची का दूसरा चरण है.
- जब आपके सेवा खाते को एपीआई कॉल करने की अनुमति मिल जाए, तब DV360 सेलर एपीआई से जुड़े दस्तावेज़ देखें. अगर आपको ऑथराइज़ेशन टोकन मैन्युअल तरीके से पाना है, तो oauth2l टूल रिपॉज़िटरी में दिए गए निर्देश देखें. इसके लिए, डाउनलोड की गई JSON सेवा खाते की कुंजी का इस्तेमाल करें. प्रोग्राम के हिसाब से OAuth टोकन पाने के बारे में ज़्यादा जानकारी, Google Cloud Authentication के दस्तावेज़ में उपलब्ध है.
अहम जानकारी: OAuth का दायरा https://www.googleapis.com/auth/doubleclickbidmanager होना चाहिए