Method: sdfdownloadtasks.create

建立 SDF 下載工作。傳回 Operation。

SDF 下載工作是長時間執行的非同步作業。這項作業的 metadata 類型為 SdfDownloadTaskMetadata。如果要求成功，作業的 response 類型會是 SdfDownloadTask。回應不會包含下載檔案，必須使用 media.download 擷取。

您可以使用 sdfdownloadtasks.operations.get 擷取作業狀態。

如有任何錯誤，可在error.message中查看。請注意，error.details 應為空白。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

要求主體

要求主體會包含結構如下的資料：

JSON 表示法 
{
  "version": enum (SdfVersion),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "partnerId": string,
  "advertiserId": string
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "parentEntityFilter": {
    object (ParentEntityFilter)
  },
  "idFilter": {
    object (IdFilter)
  },
  "inventorySourceFilter": {
    object (InventorySourceFilter)
  }
  // End of mutually exclusive fields.
}
欄位
version

enum (SdfVersion)

必填。下載檔案的 SDF 版本。如果設為 SDF_VERSION_UNSPECIFIED，系統會預設為 root_id 識別的廣告主或夥伴指定的版本。除非另有設定，否則廣告主會沿用夥伴的 SDF 版本。
必填。根 ID 會決定下載要求的背景資訊。必須設定一個欄位。以下是互斥欄位清單。回應中最多會設定下列其中一個欄位：
partnerId

string (int64 format)

要下載 SDF 的夥伴 ID。
advertiserId

string (int64 format)

要下載 SDF 的廣告主 ID。
互斥欄位結束。
必填。指定要下載的實體類型和範圍。必須設定一個欄位。以下是互斥欄位清單。回應中最多會設定下列其中一個欄位：
parentEntityFilter

object (ParentEntityFilter)

依所選檔案類型篩選。系統會根據所選的一組篩選器實體，篩選每個檔案中的實體。篩選器實體必須與所選檔案類型相同，或是所選檔案類型的上層類型。
idFilter

object (IdFilter)

依實體 ID 篩選實體。
inventorySourceFilter

object (InventorySourceFilter)

依 ID 篩選廣告空間來源。
互斥欄位結束。

回應主體

如果成功，回應主體會包含新建立的 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)

指定篩選器類型的 ID。這項資訊會用於篩選要擷取的實體。如果篩選器類型不是 FILTER_TYPE_NONE，則必須指定至少一個 ID。

FileType

可下載的檔案類型。

列舉
FILE_TYPE_UNSPECIFIED 如果未指定類型，或這個版本不支援該類型，則會使用預設值。
FILE_TYPE_CAMPAIGN 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 廣告群組 - 品質確保格式。

FilterType

可篩選的可能類型。

列舉
FILTER_TYPE_UNSPECIFIED 如果未指定類型，或這個版本不支援該類型，則會使用預設值。
FILTER_TYPE_NONE 如果選取這個選項，系統就不會對下載內容套用任何篩選條件。只有在 CreateSdfDownloadTaskRequest 中指定 Advertiser 時，才能使用這個選項。
FILTER_TYPE_ADVERTISER_ID 廣告主 ID。如果選取，所有篩選器 ID 都必須是屬於 CreateSdfDownloadTaskRequest 中指定 Partner 的廣告主 ID。
FILTER_TYPE_CAMPAIGN_ID 廣告活動 ID。如果選取，所有篩選器 ID 都必須是屬於 CreateSdfDownloadTaskRequest 中指定的 Advertiser 或 Partner 的廣告活動 ID。
FILTER_TYPE_MEDIA_PRODUCT_ID 媒體產品 ID。如果選取，所有篩選器 ID 都必須是屬於 CreateSdfDownloadTaskRequest 中指定 Advertiser 或 Partner 的媒體產品 ID。只能用於下載 FILE_TYPE_MEDIA_PRODUCT。
FILTER_TYPE_INSERTION_ORDER_ID 廣告訂單 ID。如果選取，所有篩選器 ID 都必須是屬於 CreateSdfDownloadTaskRequest 中指定的Advertiser或Partner的廣告訂單 ID。只能用於下載 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 商品項目 ID。如果選取，所有篩選器 ID 都必須是屬於 CreateSdfDownloadTaskRequest 中指定的 Advertiser 或 Partner 的商品項目 ID。只能用於下載 FILE_TYPE_LINE_ITEM、FILE_TYPE_LINE_ITEM_QA、FILE_TYPE_AD_GROUP、FILE_TYPE_AD_GROUP_QA 和 FILE_TYPE_AD。

IdFilter

依實體 ID 篩選實體的選項。

JSON 表示法 
{
  "campaignIds": [
    string
  ],
  "mediaProductIds": [
    string
  ],
  "insertionOrderIds": [
    string
  ],
  "lineItemIds": [
    string
  ],
  "adGroupIds": [
    string
  ],
  "adGroupAdIds": [
    string
  ],
  "lineItemQaIds": [
    string
  ],
  "adGroupQaIds": [
    string
  ]
}
欄位
campaignIds[]

string (int64 format)

要依 ID 下載的廣告活動。所有 ID 都必須屬於 CreateSdfDownloadTaskRequest 中指定的相同 Advertiser 或 Partner。
mediaProductIds[]

string (int64 format)

要依 ID 下載的媒體產品。所有 ID 都必須屬於 CreateSdfDownloadTaskRequest 中指定的同一個 Advertiser 或 Partner。
insertionOrderIds[]

string (int64 format)

要依 ID 下載的廣告訂單。所有 ID 都必須屬於 CreateSdfDownloadTaskRequest 中指定的同一個 Advertiser 或 Partner。
lineItemIds[]

string (int64 format)

要依 ID 下載的委刊項。所有 ID 都必須屬於 CreateSdfDownloadTaskRequest 中指定的相同 Advertiser 或 Partner。
adGroupIds[]

string (int64 format)

要下載的 YouTube 廣告群組 ID。所有 ID 都必須屬於 CreateSdfDownloadTaskRequest 中指定的相同 Advertiser 或 Partner。
adGroupAdIds[]

string (int64 format)

要依 ID 下載的 YouTube 廣告。所有 ID 都必須屬於 CreateSdfDownloadTaskRequest 中指定的相同 Advertiser 或 Partner。
lineItemQaIds[]

string (int64 format)

(選用步驟) 要以 QA 格式下載的委刊項 (依 ID)。所有 ID 都必須屬於 CreateSdfDownloadTaskRequest 中指定的相同 Advertiser 或 Partner。
adGroupQaIds[]

string (int64 format)

(選用步驟) 要以品質確保格式下載的 YouTube 廣告群組 (依 ID)。所有 ID 都必須屬於 CreateSdfDownloadTaskRequest 中指定的相同 Advertiser 或 Partner。

InventorySourceFilter

篩選廣告空間來源實體的篩選選項。

JSON 表示法 
{
  "inventorySourceIds": [
    string
  ]
}
欄位
inventorySourceIds[]

string (int64 format)

要依 ID 下載的廣告空間來源。所有 ID 都必須屬於 CreateSdfDownloadTaskRequest 中指定的相同 Advertiser 或 Partner。如果留空，系統會下載所選廣告主或夥伴的所有廣告空間來源。