Method: sdfdownloadtasks.create

Membuat Tugas Download SDF. Menampilkan Operation.

Tugas Download SDF adalah operasi asinkron yang berjalan lama. Jenis operasi metadata ini adalah SdfDownloadTaskMetadata. Jika permintaan berhasil, jenis operasi response adalah SdfDownloadTask. Respons tidak akan menyertakan file download, yang harus diambil dengan media.download. Status operasi dapat diambil dengan sdfdownloadtask.operations.get.

Semua error dapat ditemukan di error.message. Perhatikan bahwa error.details diharapkan kosong.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi 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.
}
Kolom
version

enum (SdfVersion)

Wajib. Versi SDF dari file yang didownload. Jika disetel ke SDF_VERSION_UNSPECIFIED, setelan ini akan ditetapkan secara default ke versi yang ditentukan oleh pengiklan atau partner yang diidentifikasi oleh root_id. Pengiklan mewarisi versi SDF dari partnernya, kecuali jika dikonfigurasi lain.
Kolom union root_id. Wajib. ID root menentukan konteks permintaan download. Tepatnya satu kolom yang harus ditetapkan. root_id hanya dapat berupa salah satu dari berikut:
partnerId

string (int64 format)

ID partner untuk mendownload SDF.
advertiserId

string (int64 format)

ID pengiklan untuk mendownload SDF.
Kolom union filtering_option. Wajib. Opsi yang menentukan jenis dan rentang entity yang akan didownload. Tepatnya satu kolom yang harus ditetapkan. filtering_option hanya dapat berupa salah satu dari berikut:
parentEntityFilter

object (ParentEntityFilter)

Memfilter jenis file yang dipilih. Entitas dalam setiap file difilter berdasarkan kumpulan entitas filter yang dipilih. Entitas filter harus memiliki jenis yang sama dengan, atau jenis induk dari, jenis file yang dipilih.
idFilter

object (IdFilter)

Filter pada entitas menurut ID entitasnya.
inventorySourceFilter

object (InventorySourceFilter)

Memfilter Sumber Inventaris menurut ID-nya.

Isi respons

Jika berhasil, isi respons memuat instance Operation yang baru dibuat.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

ParentEntityFilter

Opsi pemfilteran yang memfilter jenis file yang dipilih yang termasuk dalam kumpulan entitas filter yang dipilih.

Representasi JSON 
{
  "fileType": [
    enum (FileType)
  ],
  "filterType": enum (FilterType),
  "filterIds": [
    string
  ]
}
Kolom
fileType[]

enum (FileType)

Wajib. Jenis file yang akan ditampilkan.
filterType

enum (FilterType)

Wajib. Jenis filter yang digunakan untuk memfilter entitas yang diambil.
filterIds[]

string (int64 format)

ID jenis filter yang ditentukan. Ini digunakan untuk memfilter entity yang akan diambil. Jika jenis filter bukan FILTER_TYPE_NONE, minimal satu ID harus ditentukan.

FileType

Kemungkinan jenis file yang dapat didownload.

Enum
FILE_TYPE_UNSPECIFIED Nilai default jika jenis tidak ditentukan atau tidak diketahui dalam versi ini.
FILE_TYPE_CAMPAIGN Kampanye.
FILE_TYPE_MEDIA_PRODUCT Produk Media.
FILE_TYPE_INSERTION_ORDER Perjanjian Pemasangan Iklan.
FILE_TYPE_LINE_ITEM Item Baris.
FILE_TYPE_AD_GROUP Grup Iklan YouTube.
FILE_TYPE_AD Iklan YouTube.
FILE_TYPE_LINE_ITEM_QA Item Baris - format QA.
FILE_TYPE_AD_GROUP_QA Grup Iklan YouTube - format QA.

FilterType

Kemungkinan jenis yang dapat difilter.

Enum
FILTER_TYPE_UNSPECIFIED Nilai default jika jenis tidak ditentukan atau tidak diketahui dalam versi ini.
FILTER_TYPE_NONE Jika dipilih, tidak ada filter yang akan diterapkan pada download. Hanya dapat digunakan jika Advertiser ditentukan dalam CreateSdfDownloadTaskRequest.
FILTER_TYPE_ADVERTISER_ID ID Pengiklan. Jika dipilih, semua ID filter harus berupa ID Pengiklan yang termasuk dalam Partner yang ditentukan dalam CreateSdfDownloadTaskRequest.
FILTER_TYPE_CAMPAIGN_ID ID Kampanye. Jika dipilih, semua ID filter harus berupa ID Kampanye yang termasuk dalam Advertiser atau Partner yang ditentukan dalam CreateSdfDownloadTaskRequest.
FILTER_TYPE_MEDIA_PRODUCT_ID ID Produk Media. Jika dipilih, semua ID filter harus berupa ID Produk Media yang termasuk dalam Advertiser atau Partner yang ditentukan dalam CreateSdfDownloadTaskRequest. Hanya dapat digunakan untuk mendownload FILE_TYPE_MEDIA_PRODUCT.
FILTER_TYPE_INSERTION_ORDER_ID ID Pesanan Pemasangan Iklan. Jika dipilih, semua ID filter harus berupa ID Pesanan Pemasangan Iklan yang termasuk dalam Advertiser atau Partner yang ditentukan dalam CreateSdfDownloadTaskRequest. Hanya dapat digunakan untuk mendownload FILE_TYPE_INSERTION_ORDER, FILE_TYPE_LINE_ITEM, FILE_TYPE_LINE_ITEM_QA, FILE_TYPE_AD_GROUP, FILE_TYPE_AD_GROUP_QA, dan FILE_TYPE_AD.
FILTER_TYPE_LINE_ITEM_ID ID Item Baris. Jika dipilih, semua ID filter harus berupa ID Item Baris yang termasuk dalam Advertiser atau Partner yang ditentukan dalam CreateSdfDownloadTaskRequest. Hanya dapat digunakan untuk mendownload FILE_TYPE_LINE_ITEM, FILE_TYPE_LINE_ITEM_QA,FILE_TYPE_AD_GROUP, FILE_TYPE_AD_GROUP_QA, dan FILE_TYPE_AD.

IdFilter

Opsi pemfilteran yang memfilter entitas berdasarkan ID entitasnya.

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

string (int64 format)

Kampanye yang akan didownload menurut ID. Semua ID harus dimiliki Advertiser atau Partner yang sama yang ditentukan dalam CreateSdfDownloadTaskRequest.
mediaProductIds[]

string (int64 format)

Produk Media yang akan didownload menurut ID. Semua ID harus dimiliki Advertiser atau Partner yang sama yang ditentukan dalam CreateSdfDownloadTaskRequest.
insertionOrderIds[]

string (int64 format)

Perjanjian Pemasangan Iklan yang akan didownload menurut ID. Semua ID harus dimiliki Advertiser atau Partner yang sama yang ditentukan dalam CreateSdfDownloadTaskRequest.
lineItemIds[]

string (int64 format)

Item Baris yang akan didownload menurut ID. Semua ID harus dimiliki Advertiser atau Partner yang sama yang ditentukan dalam CreateSdfDownloadTaskRequest.
adGroupIds[]

string (int64 format)

Grup Iklan YouTube yang akan didownload menurut ID. Semua ID harus dimiliki Advertiser atau Partner yang sama yang ditentukan dalam CreateSdfDownloadTaskRequest.
adGroupAdIds[]

string (int64 format)

Iklan YouTube yang akan didownload menurut ID. Semua ID harus dimiliki Advertiser atau Partner yang sama yang ditentukan dalam CreateSdfDownloadTaskRequest.
lineItemQaIds[]

string (int64 format)

Opsional. Item Baris, menurut ID, untuk didownload dalam format QA. Semua ID harus dimiliki Advertiser atau Partner yang sama yang ditentukan dalam CreateSdfDownloadTaskRequest.
adGroupQaIds[]

string (int64 format)

Opsional. Grup Iklan YouTube, menurut ID, untuk didownload dalam format QA. Semua ID harus dimiliki Advertiser atau Partner yang sama yang ditentukan dalam CreateSdfDownloadTaskRequest.

InventorySourceFilter

Opsi pemfilteran untuk memfilter entitas Sumber Inventaris.

Representasi JSON 
{
  "inventorySourceIds": [
    string
  ]
}
Kolom
inventorySourceIds[]

string (int64 format)

Sumber Inventaris yang akan didownload menurut ID. Semua ID harus dimiliki Advertiser atau Partner yang sama yang ditentukan dalam CreateSdfDownloadTaskRequest. Kosongkan untuk mendownload semua Sumber Inventaris untuk Pengiklan atau Partner yang dipilih.