8 सितंबर, 2025 से, हर नए लाइन आइटम को यह बताना होगा कि वह यूरोपियन यूनियन (ईयू) में राजनैतिक विज्ञापन दिखाएगा या नहीं. Display & Video 360 API और एसडीएफ़ अपलोड करने की उन कार्रवाइयों को पूरा नहीं किया जा सकेगा जिनमें एलान नहीं किया गया है. इस बारे में ज़्यादा जानने के लिए कि इंटिग्रेशन को अपडेट करके यह एलान कैसे किया जाए, हमारा हटाए गए टैग और एट्रिब्यूट का पेज देखें.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

Method: sdfdownloadtasks.create

एचटीटीपी अनुरोध
अनुरोध का मुख्य हिस्सा
- JSON काेड में दिखाना
जवाब का मुख्य हिस्सा
अनुमति पाने के लिंक
ParentEntityFilter
- JSON काेड में दिखाना
FileType
FilterType
IdFilter
- JSON काेड में दिखाना
InventorySourceFilter
- JSON काेड में दिखाना
इसे आज़माएं!

एसडीएफ़ डाउनलोड करने का टास्क बनाता है. यह फ़ंक्शन Operation दिखाता है.

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

sdfdownloadtasks.operations.get से कार्रवाई की स्थिति का पता लगाया जा सकता है.

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

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

POST https://displayvideo.googleapis.com/v4/sdfdownloadtasks

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

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

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

JSON के काेड में दिखाना

JSON के काेड में दिखाना
{ "version": enum (`SdfVersion`), // Union field `root_id` can be only one of the following: "partnerId": string, "advertiserId": string // End of list of possible types for union field `root_id`. // Union field `filtering_option` can be only one of the following: "parentEntityFilter": { object (`ParentEntityFilter`) }, "idFilter": { object (`IdFilter`) }, "inventorySourceFilter": { object (`InventorySourceFilter`) } // End of list of possible types for union field `filtering_option`. }

{
  "version": enum (SdfVersion),

  // Union field root_id can be only one of the following:
  "partnerId": string,
  "advertiserId": string
  // End of list of possible types for union field root_id.

  // Union field filtering_option can be only one of the following:
  "parentEntityFilter": {
    object (ParentEntityFilter)
  },
  "idFilter": {
    object (IdFilter)
  },
  "inventorySourceFilter": {
    object (InventorySourceFilter)
  }
  // End of list of possible types for union field filtering_option.
}

फ़ील्ड
`version`	`enum (SdfVersion)` ज़रूरी है. डाउनलोड की गई फ़ाइल का एसडीएफ़ वर्शन. अगर यह नीति `SDF_VERSION_UNSPECIFIED` पर सेट की जाती है, तो यह डिफ़ॉल्ट रूप से उस वर्शन पर सेट होगी जिसकी पहचान, विज्ञापन देने वाले या पार्टनर ने `root_id` ने की है. जब तक कोई अन्य तरीका कॉन्फ़िगर नहीं किया जाता, तब तक विज्ञापन देने वाला अपने पार्टनर से एसडीएफ़ वर्शन इनहेरिट करता है.
यूनियन फ़ील्ड `root_id`. ज़रूरी है. रूट आईडी, डाउनलोड अनुरोध का संदर्भ तय करता है. सिर्फ़ एक फ़ील्ड सेट करना ज़रूरी है. `root_id` इनमें से कोई एक हो सकता है:
`partnerId`	`string (int64 format)` उस पार्टनर का आईडी जिसके लिए एसडीएफ़ डाउनलोड करना है.
`advertiserId`	`string (int64 format)` उस विज्ञापन देने वाले का आईडी जिसके लिए एसडीएफ़ डाउनलोड करना है.
यूनियन फ़ील्ड `filtering_option`. ज़रूरी है. ऐसे विकल्प जो डाउनलोड किए जाने वाले इकाई के टाइप और रेंज के बारे में बताते हैं. सिर्फ़ एक फ़ील्ड सेट करना ज़रूरी है. `filtering_option` इनमें से कोई एक हो सकता है:
`parentEntityFilter`	`object (ParentEntityFilter)` चुने गए फ़ाइल टाइप पर फ़िल्टर. हर फ़ाइल में मौजूद इकाइयों को, चुनी गई फ़िल्टर इकाइयों के हिसाब से फ़िल्टर किया जाता है. फ़िल्टर इकाइयां, चुने गए फ़ाइल टाइप के टाइप या उनका पैरंट टाइप होनी चाहिए.
`idFilter`	`object (IdFilter)` इकाइयों के आईडी के हिसाब से उनके फ़िल्टर.
`inventorySourceFilter`	`object (InventorySourceFilter)` आईडी के हिसाब से इन्वेंट्री सोर्स पर फ़िल्टर.

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

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

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

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

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

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

ParentEntityFilter

फ़िल्टर करने का एक विकल्प, जो चुनी गई फ़िल्टर इकाइयों से जुड़े चुने गए फ़ाइल टाइप को फ़िल्टर करता है.

JSON के काेड में दिखाना
{ "fileType": [ enum (`FileType`) ], "filterType": enum (`FilterType`), "filterIds": [ string ] }

फ़ील्ड

फ़ील्ड
`fileType[]`	`enum (FileType)` ज़रूरी है. लौटाए जाने वाले फ़ाइल टाइप.
`filterType`	`enum (FilterType)` ज़रूरी है. फ़ेच की गई इकाइयों को फ़िल्टर करने के लिए, फ़िल्टर का टाइप इस्तेमाल किया जाता है.
`filterIds[]`	`string (int64 format)` बताए गए फ़िल्टर टाइप के आईडी. इसका इस्तेमाल इकाइयों को फ़ेच करने के लिए किया जाता है. अगर फ़िल्टर टाइप `FILTER_TYPE_NONE` नहीं है, तो कम से कम एक आईडी डालना ज़रूरी है.

fileType[]

enum (FileType)

ज़रूरी है. लौटाए जाने वाले फ़ाइल टाइप.

filterType

enum (FilterType)

ज़रूरी है. फ़ेच की गई इकाइयों को फ़िल्टर करने के लिए, फ़िल्टर का टाइप इस्तेमाल किया जाता है.

filterIds[]

string (int64 format)

बताए गए फ़िल्टर टाइप के आईडी. इसका इस्तेमाल इकाइयों को फ़ेच करने के लिए किया जाता है. अगर फ़िल्टर टाइप FILTER_TYPE_NONE नहीं है, तो कम से कम एक आईडी डालना ज़रूरी है.

FileType

डाउनलोड की जा सकने वाली फ़ाइलों के संभावित प्रकार.

Enums
`FILE_TYPE_UNSPECIFIED`	इस वर्शन में टाइप के बारे में कोई जानकारी न होने या इसकी जानकारी न होने पर डिफ़ॉल्ट वैल्यू.
`FILE_TYPE_CAMPAIGN`	कैंपेन.
`FILE_TYPE_MEDIA_PRODUCT`	मीडिया प्रॉडक्ट.
`FILE_TYPE_INSERTION_ORDER`	इंसर्शन ऑर्डर.
`FILE_TYPE_LINE_ITEM`	लाइन आइटम.
`FILE_TYPE_AD_GROUP`	YouTube विज्ञापन ग्रुप.
`FILE_TYPE_AD`	YouTube विज्ञापन.
`FILE_TYPE_LINE_ITEM_QA`	लाइन आइटम - QA फ़ॉर्मैट.
`FILE_TYPE_AD_GROUP_QA`	YouTube विज्ञापन ग्रुप - QA फ़ॉर्मैट.

FilterType

फ़िल्टर किए जा सकने वाले डेटा के टाइप.

Enums
`FILTER_TYPE_UNSPECIFIED`	इस वर्शन में टाइप के बारे में कोई जानकारी न होने या इसकी जानकारी न होने पर डिफ़ॉल्ट वैल्यू.
`FILTER_TYPE_NONE`	अगर इसे चुना जाता है, तो डाउनलोड किए गए वीडियो पर कोई भी फ़िल्टर लागू नहीं किया जाएगा. इसका इस्तेमाल सिर्फ़ तब किया जा सकता है, जब `CreateSdfDownloadTaskRequest` में `Advertiser` की जानकारी दी गई हो.
`FILTER_TYPE_ADVERTISER_ID`	विज्ञापन देने वाले का आईडी. अगर फ़िल्टर आईडी चुना जाता है, तो सभी फ़िल्टर आईडी, विज्ञापन देने वाले के ऐसे आईडी होने चाहिए जो `CreateSdfDownloadTaskRequest` में बताए गए `Partner` से जुड़े हों.
`FILTER_TYPE_CAMPAIGN_ID`	कैंपेन आईडी. अगर चुना गया है, तो सभी फ़िल्टर आईडी, `CreateSdfDownloadTaskRequest` में बताए गए `Advertiser` या `Partner` से जुड़े कैंपेन आईडी होने चाहिए.
`FILTER_TYPE_MEDIA_PRODUCT_ID`	मीडिया प्रॉडक्ट आईडी. अगर चुना गया है, तो सभी फ़िल्टर आईडी, `CreateSdfDownloadTaskRequest` में बताए गए `Advertiser` या `Partner` से जुड़े मीडिया प्रॉडक्ट आईडी होने चाहिए. इसका इस्तेमाल सिर्फ़ `FILE_TYPE_MEDIA_PRODUCT` को डाउनलोड करने के लिए किया जा सकता है.
`FILTER_TYPE_INSERTION_ORDER_ID`	इंसर्शन ऑर्डर आईडी. अगर चुना गया है, तो सभी फ़िल्टर आईडी, इंसर्शन ऑर्डर आईडी होने चाहिए, जो `CreateSdfDownloadTaskRequest` में बताए गए `Advertiser` या `Partner` से जुड़े हों. इसका इस्तेमाल सिर्फ़ `FILE_TYPE_INSERTION_ORDER`, `FILE_TYPE_LINE_ITEM`, `FILE_TYPE_LINE_ITEM_QA`, `FILE_TYPE_AD_GROUP`, `FILE_TYPE_AD_GROUP_QA`, और `FILE_TYPE_AD` को डाउनलोड करने के लिए किया जा सकता है.
`FILTER_TYPE_LINE_ITEM_ID`	लाइन आइटम आईडी. अगर फ़िल्टर आईडी चुना जाता है, तो सभी फ़िल्टर आईडी, `CreateSdfDownloadTaskRequest` में बताए गए `Advertiser` या `Partner` से जुड़े लाइन आइटम आईडी होने चाहिए. इसका इस्तेमाल सिर्फ़ `FILE_TYPE_LINE_ITEM`, `FILE_TYPE_LINE_ITEM_QA`,`FILE_TYPE_AD_GROUP`, `FILE_TYPE_AD_GROUP_QA`, और `FILE_TYPE_AD` को डाउनलोड करने के लिए किया जा सकता है.

IdFilter

यह फ़िल्टर करने का एक विकल्प है, जो इकाइयों को उनके आईडी के हिसाब से फ़िल्टर करता है.

JSON के काेड में दिखाना
{ "campaignIds": [ string ], "mediaProductIds": [ string ], "insertionOrderIds": [ string ], "lineItemIds": [ string ], "adGroupIds": [ string ], "adGroupAdIds": [ string ], "lineItemQaIds": [ string ], "adGroupQaIds": [ string ] }

JSON के काेड में दिखाना

{
  "campaignIds": [
    string
  ],
  "mediaProductIds": [
    string
  ],
  "insertionOrderIds": [
    string
  ],
  "lineItemIds": [
    string
  ],
  "adGroupIds": [
    string
  ],
  "adGroupAdIds": [
    string
  ],
  "lineItemQaIds": [
    string
  ],
  "adGroupQaIds": [
    string
  ]
}

फ़ील्ड
`campaignIds[]`	`string (int64 format)` आईडी के हिसाब से डाउनलोड किए जाने वाले कैंपेन. सभी आईडी, `CreateSdfDownloadTaskRequest` में बताए गए एक ही `Advertiser` या `Partner` से जुड़े होने चाहिए.
`mediaProductIds[]`	`string (int64 format)` आईडी से डाउनलोड करने के लिए मीडिया प्रॉडक्ट. सभी आईडी, `CreateSdfDownloadTaskRequest` में बताए गए एक ही `Advertiser` या `Partner` से जुड़े होने चाहिए.
`insertionOrderIds[]`	`string (int64 format)` आईडी से डाउनलोड करने के लिए इंसर्शन ऑर्डर. सभी आईडी, `CreateSdfDownloadTaskRequest` में बताए गए एक ही `Advertiser` या `Partner` से जुड़े होने चाहिए.
`lineItemIds[]`	`string (int64 format)` आईडी के हिसाब से डाउनलोड करने के लिए, लाइन आइटम. सभी आईडी, `CreateSdfDownloadTaskRequest` में बताए गए एक ही `Advertiser` या `Partner` से जुड़े होने चाहिए.
`adGroupIds[]`	`string (int64 format)` आईडी के हिसाब से डाउनलोड करने के लिए, YouTube विज्ञापन ग्रुप. सभी आईडी, `CreateSdfDownloadTaskRequest` में बताए गए एक ही `Advertiser` या `Partner` से जुड़े होने चाहिए.
`adGroupAdIds[]`	`string (int64 format)` आईडी से डाउनलोड करने के लिए, YouTube विज्ञापन. सभी आईडी, `CreateSdfDownloadTaskRequest` में बताए गए एक ही `Advertiser` या `Partner` से जुड़े होने चाहिए.
`lineItemQaIds[]`	`string (int64 format)` ज़रूरी नहीं. QA फ़ॉर्मैट में डाउनलोड करने के लिए, आईडी के हिसाब से लाइन आइटम. सभी आईडी, `CreateSdfDownloadTaskRequest` में बताए गए एक ही `Advertiser` या `Partner` से जुड़े होने चाहिए.
`adGroupQaIds[]`	`string (int64 format)` ज़रूरी नहीं. QA फ़ॉर्मैट में डाउनलोड करने के लिए, आईडी के हिसाब से YouTube विज्ञापन ग्रुप. सभी आईडी, `CreateSdfDownloadTaskRequest` में बताए गए एक ही `Advertiser` या `Partner` से जुड़े होने चाहिए.

InventorySourceFilter

इन्वेंट्री सोर्स की इकाइयों को फ़िल्टर करने के लिए, फ़िल्टर करने का एक विकल्प.

JSON के काेड में दिखाना
{ "inventorySourceIds": [ string ] }

फ़ील्ड

फ़ील्ड
`inventorySourceIds[]`	`string (int64 format)` आईडी के हिसाब से डाउनलोड करने के लिए, इन्वेंट्री सोर्स. सभी आईडी, `CreateSdfDownloadTaskRequest` में बताए गए एक ही `Advertiser` या `Partner` से जुड़े होने चाहिए. चुने गए विज्ञापन देने वाले या पार्टनर के सभी इन्वेंट्री सोर्स डाउनलोड करने के लिए, फ़ील्ड को खाली छोड़ें.

inventorySourceIds[]

string (int64 format)

आईडी के हिसाब से डाउनलोड करने के लिए, इन्वेंट्री सोर्स. सभी आईडी, CreateSdfDownloadTaskRequest में बताए गए एक ही Advertiser या Partner से जुड़े होने चाहिए. चुने गए विज्ञापन देने वाले या पार्टनर के सभी इन्वेंट्री सोर्स डाउनलोड करने के लिए, फ़ील्ड को खाली छोड़ें.