Display & Video 360 API, Display & Video 360 प्लैटफ़ॉर्म के लिए प्रोग्रामैटिक इंटरफ़ेस है. Display & Video 360 के जटिल वर्कफ़्लो को ऑटोमेट करने के लिए, Display & Video 360 API का इस्तेमाल किया जा सकता है. Display & Video 360 API की मदद से किए जा सकने वाले कुछ कामों के उदाहरण यहां दिए गए हैं:
- क्रिएटिव अपलोड करना और बनाना.
- लाइन आइटम और उनकी टारगेटिंग मैनेज करना.
- स्ट्रक्चर्ड डेटा फ़ाइलें जनरेट और डाउनलोड करना.
इस गाइड में, Display & Video 360 API का इस्तेमाल शुरू करने का तरीका बताया गया है.
ज़रूरी शर्तें
Display & Video 360 API का इस्तेमाल करने से पहले, आपको ये काम करने होंगे:
आपके पास Google खाता होना चाहिए. Google API Console में प्रोजेक्ट बनाने के लिए, आपके पास Google खाता होना चाहिए. अगर आपके पास पहले से ही कोई खाता है, तो आपको कुछ और करने की ज़रूरत नहीं है. टेस्ट करने के लिए, आपके पास एक अलग Google खाता भी हो सकता है.
आपके पास Display & Video 360 का ऐक्सेस होना चाहिए. एपीआई के साथ काम करने के लिए, आपके पास Display & Video 360 प्रॉडक्ट का ऐक्सेस होना चाहिए. अगर आपके संगठन के पास पहले से ही Display & Video 360 का अनुबंध है, तो पक्का करें कि आपके Google खाते के लिए, ज़रूरी अनुमतियों वाली उपयोगकर्ता प्रोफ़ाइल बनाई गई हो. अगर ऐसा नहीं है, तो ज़्यादा जानकारी के लिए हमारी सेल्स टीम से संपर्क करें.
आपको Display & Video 360 आज़माना चाहिए. इस एपीआई दस्तावेज़ में यह माना गया है कि आपने Display & Video 360 का इस्तेमाल किया है. साथ ही, आपको वेब प्रोग्रामिंग के कॉन्सेप्ट और वेब डेटा फ़ॉर्मैट के बारे में पता है. अगर आपने Display & Video 360 का इस्तेमाल नहीं किया है, तो कोड लिखने से पहले वेब यूज़र इंटरफ़ेस आज़माएं.
कोई प्रोजेक्ट चुनें
आपको Google API Console में कोई प्रोजेक्ट बनाना या चुनना होगा और एपीआई को चालू करना होगा.
आपके पास नया प्रोजेक्ट बनाने या किसी मौजूदा प्रोजेक्ट का इस्तेमाल करने का विकल्प है.
नया प्रोजेक्ट बनाएं
प्रोजेक्ट बनाने और Display & Video 360 API को अपने-आप चालू करने के लिए, Google API कंसोल में दिए गए निर्देशों का पालन करें.
किसी मौजूदा प्रोजेक्ट का इस्तेमाल करना
किसी मौजूदा प्रोजेक्ट के लिए, Display & Video 360 API को मैन्युअल तरीके से चालू करने का तरीका यहां बताया गया है.
अपने प्रोजेक्ट के लिए एपीआई चालू करने के लिए, यह तरीका अपनाएं:
- Google API Console में, एपीआई लाइब्रेरी खोलें. अगर कहा जाए, तो कोई प्रोजेक्ट चुनें या नया प्रोजेक्ट बनाएं. एपीआई लाइब्रेरी में, सभी उपलब्ध एपीआई की सूची होती है. इन्हें प्रॉडक्ट फ़ैमिली और लोकप्रियता के हिसाब से ग्रुप किया जाता है.
- अगर आपको जो एपीआई चालू करना है वह सूची में नहीं दिख रहा है, तो उसे खोजने के लिए खोज बार का इस्तेमाल करें.
- वह एपीआई चुनें जिसे आपको चालू करना है. इसके बाद, चालू करें बटन पर क्लिक करें.
- अगर कहा जाए, तो बिलिंग चालू करें.
- अगर कहा जाए, तो एपीआई की सेवा की शर्तें स्वीकार करें.
क्रेडेंशियल जनरेट करना
Display & Video 360 API के लिए किए गए सभी अनुरोधों को अनुमति दी जानी चाहिए. अनुमति के बारे में खास जानकारी पाने के लिए, Google को अपने ऐप्लिकेशन की अनुमति देने और उसकी पहचान करने का तरीका जानें.
यहां दिए गए निर्देशों की मदद से, इंस्टॉल किए गए ऐप्लिकेशन के फ़्लो के साथ इस्तेमाल करने के लिए, OAuth 2.0 क्लाइंट आईडी बनाने का तरीका जानें. सेवा खाते के फ़्लो के साथ इस्तेमाल करने के लिए क्रेडेंशियल जनरेट करने के निर्देशों के लिए, सेवा खाते की गाइड देखें.
Google API कंसोल प्रोजेक्ट को कॉन्फ़िगर करने के लिए, यह तरीका अपनाएं.
- API Console में क्रेडेंशियल पेज खोलें.
क्रेडेंशियल बनाएं > OAuth क्लाइंट आईडी पर क्लिक करें.
जब कहा जाए, तब अपने हिसाब से सबसे सही ऐप्लिकेशन टाइप चुनें. इन गाइड में दिए गए Java और Python कोड स्निपेट, डेस्कटॉप ऐप्लिकेशन के लिए हैं. वहीं, PHP कोड स्निपेट, वेब ऐप्लिकेशन के लिए हैं.
अगर कोई और ज़रूरी जानकारी है, तो उसे डालें.
- अगर पहली बार क्लाइंट आईडी बनाया जा रहा है, तो ऐप्लिकेशन टाइप चुनने के अलावा, सहमति स्क्रीन कॉन्फ़िगर करें बटन पर क्लिक करके, सहमति स्क्रीन को कॉन्फ़िगर किया जा सकता है. पहली बार सहमति स्क्रीन कॉन्फ़िगर करने के बाद, आपको इसे फिर से कॉन्फ़िगर करने के लिए कहा नहीं जाएगा. हालांकि, इस जानकारी को कभी भी अपडेट किया जा सकता है.
बनाएं पर क्लिक करें.
इसके बाद, आपको OAuth 2.0 क्लाइंट आईडी और क्लाइंट सीक्रेट दिखेगा. इसे JSON फ़ॉर्मैट में डाउनलोड करके, बाद में इस्तेमाल के लिए सेव किया जा सकता है.
उपयोगकर्ता की सहमति वाली स्क्रीन को कॉन्फ़िगर करना
पुष्टि करने के लिए OAuth 2.0 का इस्तेमाल करने पर, उपयोगकर्ताओं की पुष्टि तब की जाती है, जब वे उपयोगकर्ता की सहमति वाली स्क्रीन पर बताई गई शर्तों से सहमत हो जाते हैं.
अपने प्रोजेक्ट की सहमति वाली स्क्रीन सेट अप करने के लिए, यह तरीका अपनाएं:
- Google API Console में, सहमति वाली स्क्रीन का पेज खोलें. अगर कहा जाए, तो कोई प्रोजेक्ट चुनें या नया प्रोजेक्ट बनाएं.
- फ़ॉर्म भरें और सेव करें पर क्लिक करें.