Method: advertisers.sdfuploadtasks.upload

एसडीएफ़ अपलोड टास्क बनाता है. Operation दिखाता है.

एसडीएफ़ अपलोड टास्क, लंबे समय तक चलने वाला और एसिंक्रोनस ऑपरेशन है. इस ऑपरेशन का metadata टाइप SdfUploadTaskMetadata है. अगर अनुरोध पूरा हो जाता है, तो response कार्रवाई का टाइप SdfUploadTask होता है. रिस्पॉन्स में, नतीजों वाली फ़ाइलें शामिल नहीं होंगी. इन्हें media.download का इस्तेमाल करके वापस पाया जा सकता है.

sdfuploadtask.operations.get की मदद से, ऑपरेशन की स्थिति देखी जा सकती है.

error.message में कोई भी गड़बड़ी देखी जा सकती है. ध्यान दें कि error.details की वैल्यू खाली होनी चाहिए.

एचटीटीपी अनुरोध

  • मीडिया अपलोड करने के अनुरोधों के लिए, अपलोड यूआरआई:
    POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/sdfuploadtasks
  • सिर्फ़ मेटाडेटा के अनुरोधों के लिए मेटाडेटा यूआरआई:
    POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/sdfuploadtasks

यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.

पाथ पैरामीटर

पैरामीटर
advertiserId

string (int64 format)

ज़रूरी है. विज्ञापन देने वाले उस व्यक्ति या कंपनी का आईडी जिसके लिए एसडीएफ़ अपलोड करना है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में, नीचे दिए गए स्ट्रक्चर वाला डेटा होता है:

JSON के काेड में दिखाना 
{
  "filename": string,
  "sdfVersion": enum (SdfVersion)
}
फ़ील्ड
filename

string

ज़रूरी है. ऐसेट का फ़ाइल नाम, जिसमें फ़ाइल एक्सटेंशन भी शामिल है. फ़ाइल का नाम, UTF-8 कोड में होना चाहिए. साथ ही, इसका साइज़ 240 बाइट से ज़्यादा नहीं होना चाहिए.
sdfVersion

enum (SdfVersion)

ज़रूरी है. अपलोड की गई फ़ाइल का SDF वर्शन. अगर इसे SDF_VERSION_UNSPECIFIED पर सेट किया जाता है, तो यह डिफ़ॉल्ट रूप से उस वर्शन पर सेट हो जाएगा जिसे विज्ञापन देने वाले ने बताया है. जब तक विज्ञापन देने वाला, अपने पार्टनर के साथ किसी दूसरे वर्शन को कॉन्फ़िगर नहीं करता, तब तक वह अपने पार्टनर से SDF का वर्शन इनहेरिट करता है.

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में Operation का एक इंस्टेंस शामिल किया जाता है.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/display-video

ज़्यादा जानकारी के लिए, OAuth 2.0 Overview देखें.