Method: advertisers.sdfuploadtasks.upload

Membuat Tugas Upload SDF. Menampilkan Operation.

Tugas Upload SDF adalah operasi asinkron yang berjalan lama. Jenis metadata operasi ini adalah SdfUploadTaskMetadata. Jika permintaan berhasil, jenis response operasi adalah SdfUploadTask. Respons tidak akan menyertakan file yang dihasilkan, yang kemudian dapat diambil menggunakan media.download.

Status operasi dapat diambil dengan sdfuploadtask.operations.get.

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

Permintaan HTTP

  • URI upload, untuk permintaan upload media:
    POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/sdfuploadtasks
  • URI metadata, khusus untuk permintaan metadata:
    POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/sdfuploadtasks

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
advertiserId

string (int64 format)

Wajib. ID pengiklan yang akan mengupload SDF.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "filename": string,
  "sdfVersion": enum (SdfVersion)
}
Kolom
filename

string

Wajib. Nama file aset, termasuk ekstensi file. Nama file harus dienkode UTF-8 dengan ukuran maksimum 240 byte.
sdfVersion

enum (SdfVersion)

Wajib. Versi SDF file yang diupload. Jika ditetapkan ke SDF_VERSION_UNSPECIFIED, nilai ini akan ditetapkan secara default ke versi yang ditentukan oleh pengiklan yang diidentifikasi. Pengiklan mewarisi versi SDF dari partnernya, kecuali jika dikonfigurasi sebaliknya.

Isi respons

Jika berhasil, isi respons memuat instance Operation.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.