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

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

Method: sdfdownloadtasks.create

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

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

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

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

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

POST https://displayvideo.googleapis.com/v3/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 वर्शन. अगर इसे `SDF_VERSION_UNSPECIFIED` पर सेट किया जाता है, तो यह डिफ़ॉल्ट रूप से उस वर्शन पर सेट हो जाएगा जिसे विज्ञापन देने वाले या `root_id` से पहचाने गए पार्टनर ने तय किया है. जब तक कोई अन्य तरीका कॉन्फ़िगर नहीं किया जाता, तब तक विज्ञापन देने वाला अपने पार्टनर से एसडीएफ़ वर्शन इनहेरिट करता है.
यूनियन फ़ील्ड `root_id`. ज़रूरी है. रूट आईडी से, डाउनलोड के अनुरोध का कॉन्टेक्स्ट तय होता है. कम से कम एक फ़ील्ड सेट होना चाहिए. `root_id` इनमें से कोई एक हो सकता है:
`partnerId`	`string (int64 format)` SDF डाउनलोड करने के लिए पार्टनर का आईडी.
`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 की खास जानकारी देखें.

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`	लाइन आइटम - क्वालिटी जांच का फ़ॉर्मैट.
`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)` ज़रूरी नहीं. YouTube विज्ञापन ग्रुप, आईडी के हिसाब से, क्वालिटी एश्योरेंस (क्यूए) फ़ॉर्मैट में डाउनलोड करने के लिए. सभी आईडी, `CreateSdfDownloadTaskRequest` में बताए गए एक ही `Advertiser` या `Partner` से जुड़े होने चाहिए.

InventorySourceFilter

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

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

फ़ील्ड

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

inventorySourceIds[]

string (int64 format)

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