DV360 Exchange Reporting API की मदद से, तीसरे पक्ष के एक्सचेंज (3PE) पार्टनर, Display &Video 360 की परफ़ॉर्मेंस रिपोर्ट को प्रोग्राम के ज़रिए ऐक्सेस कर सकते हैं.
DV360 Exchange Reporting API, अनुमति वाली सूची पर आधारित Google Cloud API के तौर पर उपलब्ध है. यह OAuth का इस्तेमाल करता है. अनुमति वाली सूची में शामिल करने की प्रोसेस, DV360 Exchange Reporting API की टीम मैनेज करती है.
काम का तरीका
DV360 Exchange Reporting API के लिए ऑनबोर्ड करने के चरण यहां दिए गए हैं:
Google Cloud Console पर, Google खाते के लिए साइन अप करें.
ध्यान दें कि इस खाते का इस्तेमाल, आपके प्रोडक्शन क्लाइंट के लिए ऐक्सेस टोकन मैनेज करने के लिए किया जाना है. इसलिए, अपने निजी Gmail खाते का इस्तेमाल न करें.
खाते की जानकारी के साथ, Google DV360 से संपर्क करें, ताकि उसे अनुमति वाली सूची में जोड़ा जा सके.
आपको अनुमति वाली सूची में शामिल किए जाने की सूचना मिलने के बाद, OAuth की पुष्टि की समीक्षा का अनुरोध करें, ताकि आपके ऐप्लिकेशन को
doubleclickbidmanagerस्कोप का ऐक्सेस मिल सके.Google Cloud Console में साइन इन करें.
एपीआई और सेवाएं > लाइब्रेरी > निजी पर जाएं. आपको DV360 Exchange Reporting API, आपके लिए उपलब्ध एपीआई में से एक के तौर पर दिखना चाहिए. DV360 Exchange Reporting API को चालू करें.
क्रेडेंशियल > क्रेडेंशियल बनाएं > सेवा खाते की पर जाएं. सेवा खाता बनाने के लिए, निर्देशों का पालन करें.
सेवा खाता
सेवा खाते की मदद से, आपका कोड सीधे तौर पर एपीआई को ऐप्लिकेशन के क्रेडेंशियल भेज सकता है. सेवा खाते को ईमेल पते से दिखाया जाता है. यह उपयोगकर्ता खाते की तरह ही होता है. हालांकि, उपयोगकर्ता खाते के उलट, सेवा खाता सिर्फ़ किसी ऐप्लिकेशन का होता है. इसका इस्तेमाल सिर्फ़ उस एपीआई को ऐक्सेस करने के लिए किया जा सकता है जिसके लिए इसे बनाया गया है.
Google Cloud 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 फ़ाइल को सुरक्षित तरीके से सेव करें, क्योंकि इसमें आपकी निजी कुंजी होती है. साथ ही, यह फ़ाइल उस कुंजी की इकलौती कॉपी होती है. जब आपका कोड, एपीआई को कॉल करता है, तब इस फ़ाइल में मौजूद क्रेडेंशियल की ज़रूरत होती है.
बनाए गए सेवा खाते की जानकारी के साथ, DV360 से संपर्क करें. खास तौर पर, सेवा खाते का ईमेल पता दें. यह एपीआई ऐक्सेस के लिए, अनुमति वाली सूची में शामिल करने की प्रोसेस का हिस्सा है.
ऐक्सेस टोकन
एपीआई को कॉल करने के लिए, आपके सेवा खाते को अनुमति मिलने के बाद, एपीआई गाइड में दिए गए उदाहरणों के हिसाब से काम किया जा सकता है. ऐक्सेस टोकन को मैन्युअल तरीके से पाने के लिए, oauth2l जैसे टूल का इस्तेमाल किया जा सकता है. इसके अलावा, प्रोग्राम के ज़रिए पुष्टि करने के लिए, हमारी किसी क्लाइंट लाइब्रेरी का इस्तेमाल किया जा सकता है.