DV360 सेलर एपीआई को शामिल करना
DV360 Seller API के लिए एपीआई को शामिल करने के कुछ मुख्य चरण हैं. DV360 सेलर एपीआई को अनुमति वाली सूची के आधार पर Google Cloud API के तौर पर दिखाया जाता है. साथ ही, पुष्टि करने के लिए OAuth का इस्तेमाल किया जाता है.
अनुमति वाली सूची में शामिल करने की प्रोसेस को मैनेज करने के लिए, DV360 Seller API टीम से संपर्क करें.
शामिल होने का तरीका:
- https://console.cloud.google.com/ पर जाकर, Google खाता साइन अप करें
- इस खाते का इस्तेमाल, आपके प्रॉडक्शन क्लाइंट के लिए ऐक्सेस टोकन मैनेज करने के लिए किया जाएगा. अपने निजी Gmail खाते का इस्तेमाल न करें.
- यह खाता, Google ग्रुप नहीं हो सकता.
- अगर किसी मौजूदा Google Cloud प्रोजेक्ट का इस्तेमाल किया जा रहा है, तो: खाता, प्रोजेक्ट का एडमिन होना चाहिए.
- अनुमति वाली सूची में जोड़ने के लिए, उस खाते की जानकारी के साथ Google DV360 से संपर्क करें जिससे आपने साइन अप किया है.
- अपने खाते को अनुमति वाली सूची में जोड़े जाने का इंतज़ार करें.
- ज़रूरी नहीं और ब्लॉक नहीं करता: स्कोप(doubleclickbidmanager) को ऐक्सेस करने के लिए, अपने ऐप्लिकेशन के लिए OAuth पुष्टि की समीक्षा का अनुरोध सबमिट करें.
- https://console.cloud.google.com/ पर जाएं. एपीआई और सेवाएं -> लाइब्रेरी -> निजी पर जाएं. आपको DV360 सेलर एपीआई, उपलब्ध एपीआई में से एक के तौर पर दिखेगा.
- DV360 Seller API चालू करना
- क्रेडेंशियल -> क्रेडेंशियल बनाएं -> सेवा खाते की कुंजी पर जाएं. यहां दिए गए निर्देशों का पालन करें: https://developers.google.com/identity/protocols/OAuth2ServiceAccount
सेवा खाता सेट अप करने के लिए:
ध्यान दें: अगर आपको किसी मौजूदा सेवा खाते का फिर से इस्तेमाल करना है, तो हमें बताएं. जैसे, DV360 Reporting API के लिए.Google Cloud API की पुष्टि और अनुमति (आम तौर पर "पुष्टि" के तौर पर एक साथ ग्रुप की जाती है) आम तौर पर, सेवा खाते का इस्तेमाल करके की जाती है. सेवा खाते की मदद से, आपके कोड को ऐप्लिकेशन क्रेडेंशियल सीधे Cloud API को भेजने की अनुमति मिलती है. उपयोगकर्ता खाते की तरह ही, सेवा खाते को भी ईमेल पते से दिखाया जाता है. हालांकि, उपयोगकर्ता खाते के उलट, सेवा खाता सिर्फ़ किसी ऐप्लिकेशन से जुड़ा होता है. इसका इस्तेमाल सिर्फ़ उस एपीआई को ऐक्सेस करने के लिए किया जा सकता है जिसके लिए इसे बनाया गया था. उदाहरण के लिए, हम Google Cloud Platform कंसोल का इस्तेमाल करके, सेवा खाते के क्रेडेंशियल बनाने का तरीका बताएंगे.
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 से संपर्क करें. खास तौर पर, हमें इस सेवा खाते के ईमेल पते की ज़रूरत होगी. अनुमति देने के लिए, यह अनुमति सूची की एक और प्रोसेस है.
- जब आपके सेवा खाते को एपीआई को कॉल करने की अनुमति मिल जाती है, तो एपीआई के दस्तावेज़ के लिए https://developers.google.com/display-video/seller पर जाएं. पुष्टि करने वाला टोकन मैन्युअल तरीके से पाने के लिए, यहां दिए गए निर्देश देखें: https://github.com/google/oauth2l. (आपको अपने सेवा खाते की कुंजी का JSON वर्शन पहले से डाउनलोड करना होगा). प्रोग्राम के हिसाब से Oauth टोकन पाने के तरीके के बारे में ज़्यादा जानकारी यहां दी गई है: https://cloud.google.com/docs/authentication/production.
अहम जानकारी: OAuth स्कोप 'doubleclickbidmanager' होना चाहिए