मीडिया अपलोड करें

मीडिया अपलोड करने की सुविधा की मदद से, ऐसा डेटा सेव किया जा सकता है जिसका इस्तेमाल Display & Video 360 में किया जा सकता है. अपलोड किए जाने वाले डेटा में फ़ोटो, वीडियो, ज़िप फ़ाइलें वगैरह शामिल हो सकती हैं.

अपलोड के विकल्प

Display & Video 360 API की मदद से, कुछ तरह का बाइनरी डेटा या मीडिया अपलोड किया जा सकता है. अपलोड किए जा सकने वाले डेटा की खास बातें, मीडिया अपलोड करने की सुविधा देने वाले किसी भी टास्क के लिए, डेवलपर गाइड में बताई गई हैं:

अपलोड की जाने वाली फ़ाइल का ज़्यादा से ज़्यादा साइज़: इस तरीके से, ज़्यादा से ज़्यादा इतना डेटा स्टोर किया जा सकता है.
मीडिया के लिए इस्तेमाल किए जा सकने वाले MIME टाइप: इस तरीके का इस्तेमाल करके, किस तरह का बाइनरी डेटा सेव किया जा सकता है.

इनमें से किसी भी तरीके से, अपलोड करने के अनुरोध किए जा सकते हैं. uploadType पैरामीटर के साथ इस्तेमाल किए जा रहे तरीके के बारे में बताएं.

आसानी से अपलोड करना: uploadType=media. लगभग 5 एमबी या इससे कम साइज़ की फ़ाइलों को तेज़ी से ट्रांसफ़र करने के लिए.
कई हिस्सों में अपलोड करना: uploadType=multipart. फ़ाइलों और उनसे जुड़े मेटाडेटा को तुरंत ट्रांसफ़र करने की सुविधा. यह फ़ाइल और मेटाडेटा को एक ही अनुरोध में ट्रांसफ़र करता है.

मीडिया अपलोड करते समय, /upload यूआरआई का इस्तेमाल किया जाता है. मीडिया डेटा ट्रांसफ़र करते समय, इस यूआरआई का इस्तेमाल करें.

उदाहरण:

  POST /upload/media/resource-name

आसानी से अपलोड करना

अपलोड करने का सामान्य अनुरोध, फ़ाइल अपलोड करने का सबसे आसान तरीका है. यह विकल्प तब चुनें, जब:

अगर ज़रूरी हो, तो फ़ाइल को फिर से अपलोड किया जा सकता है.
भेजने के लिए कोई मेटाडेटा नहीं है. ऐसा तब हो सकता है, जब मेटाडेटा ज़रूरी न हो या अनुरोध में कहीं और शामिल किया गया हो.

आसान तरीके से अपलोड करने की सुविधा का इस्तेमाल करने के लिए, /upload यूआरआई के लिए POST या PUT अनुरोध करें और क्वेरी पैरामीटर uploadType=media जोड़ें. उदाहरण के लिए:

  POST https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media

सामान्य अपलोड करते समय इस्तेमाल किए जाने वाले एचटीटीपी हेडर में ये शामिल हैं:

Content-Type. इसे, तरीके के लिए स्वीकार किए गए मीडिया डेटा टाइप में से किसी एक पर सेट करें.
Content-Length. इसे अपलोड किए जा रहे बाइट की संख्या पर सेट करें. अगर चंक किए गए ट्रांसफ़र एन्कोडिंग का इस्तेमाल किया जा रहा है, तो इसकी ज़रूरत नहीं है.

कई हिस्सों में अपलोड करना

अगर आपको अपलोड किए जाने वाले डेटा के साथ मेटाडेटा भेजना है, तो multipart/related अनुरोध किया जा सकता है. अगर आपको लगता है कि भेजा गया डेटा इतना छोटा है कि उसे फिर से अपलोड किया जा सकता है, तो यह विकल्प चुनें.

मल्टीपार्ट अपलोड का इस्तेमाल करने के लिए, POST या PUT तरीके के /upload यूआरआई को अनुरोध करें और क्वेरी पैरामीटर uploadType=multipart जोड़ें. उदाहरण के लिए:

  POST https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart

कई हिस्सों में अपलोड करने का अनुरोध करते समय, टॉप-लेवल के इन एचटीटीपी हेडर का इस्तेमाल किया जा सकता है:

Content-Type. इसे multipart/related पर सेट करें. साथ ही, वह बाउंड्री स्ट्रिंग शामिल करें जिसका इस्तेमाल अनुरोध के हिस्सों की पहचान करने के लिए किया जा रहा है.
Content-Length. इसे अनुरोध के मुख्य हिस्से में मौजूद बाइट की कुल संख्या पर सेट करें. अनुरोध का मीडिया हिस्सा, इस तरीके की फ़ाइल के लिए तय किए गए ज़्यादा से ज़्यादा साइज़ से कम होना चाहिए.

अनुरोध के मुख्य हिस्से को multipart/related कॉन्टेंट टाइप [RFC2387] के तौर पर फ़ॉर्मैट किया गया है. इसमें सिर्फ़ दो हिस्से होते हैं. इन हिस्सों की पहचान, बाउंड्री स्ट्रिंग से की जाती है. साथ ही, आखिरी बाउंड्री स्ट्रिंग के बाद दो हाइफ़न होते हैं.

मल्टीपार्ट अनुरोध के हर हिस्से के लिए, एक और Content-Type हेडर की ज़रूरत होती है:

मेटाडेटा वाला हिस्सा: यह सबसे पहले होना चाहिए. साथ ही, Content-Type, मेटाडेटा के स्वीकार किए गए किसी एक फ़ॉर्मैट से मेल खाना चाहिए.
मीडिया पार्ट: यह दूसरा होना चाहिए. साथ ही, Content-Type को, तरीके के स्वीकार किए गए मीडिया MIME टाइप में से किसी एक से मेल खाना चाहिए.

उदाहरण

अलग-अलग टास्क पूरे करने के लिए, Display & Video 360 API का इस्तेमाल करके मीडिया अपलोड किया जाता है. इस सेक्शन में, कर्ल अनुरोधों के उदाहरण दिए गए हैं.

क्रिएटिव ऐसेट अपलोड करें

क्रिएटिव ऐसेट अपलोड करने का तरीका यहां बताया गया है:

curl --request POST \
  'https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart' \
  --header 'Authorization: Bearer access-token' \
   -F "data={\"filename\": \"asset-filename\"};type=application/json;charset=UTF-8" \
   -F "file=@asset-path;type=asset-mime-type"

ज़्यादा जानकारी और कोड के उदाहरणों के लिए, क्रिएटिव ऐसेट अपलोड करना गाइड देखें.

कस्टम बिडिंग स्क्रिप्ट फ़ाइल अपलोड करना

स्क्रिप्ट फ़ाइल अपलोड करने का तरीका यहां बताया गया है:

curl --request POST \
  'https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media' \
  -H 'authorization: Bearer access-token' \
  -H 'Content-Type: text/plain' \
  --data-binary @script-path

ज़्यादा जानकारी और कोड के उदाहरणों के लिए, अपलोड स्क्रिप्ट गाइड देखें.