Upload media

Fitur upload media memungkinkan Anda menyimpan data yang dapat digunakan di Display & Video 360. Jenis data yang mungkin ingin diupload mencakup foto, video, file zip, dll.

Opsi upload

Display & Video 360 API memungkinkan Anda mengupload jenis data biner atau media tertentu. Karakteristik data yang dapat Anda upload dijelaskan dalam panduan developer untuk tugas apa pun yang memerlukan upload media:

  • Ukuran file upload maksimum: Jumlah data maksimum yang dapat Anda simpan dengan metode ini.
  • Jenis MIME media yang diterima: Jenis data biner yang dapat Anda simpan menggunakan metode ini.

Anda dapat membuat permintaan upload dengan salah satu cara berikut. Tentukan metode yang Anda gunakan dengan parameter uploadType.

  • Upload sederhana: uploadType=media. Transfer cepat untuk file berukuran sekitar 5 MB atau kurang.
  • Upload multibagian: uploadType=multipart. Transfer cepat untuk file dan metadata yang relevan. Mentransfer file dan metadata, semuanya dalam satu permintaan.

Saat mengupload media, Anda menggunakan URI /upload. Gunakan URI ini saat mentransfer data media itu sendiri.

Contoh:

  POST /upload/media/resource-name

Upload sederhana

Permintaan upload sederhana adalah metode paling mudah untuk mengupload file. Opsi ini adalah pilihan yang baik jika:

  • File cukup kecil untuk diupload lagi, jika perlu.
  • Tidak ada metadata yang akan dikirim. Hal ini mungkin berlaku jika metadata tidak diperlukan atau disertakan di tempat lain dalam permintaan.

Untuk menggunakan upload sederhana, buat permintaan POST atau PUT ke URI /upload metode dan tambahkan parameter kueri uploadType=media. Contoh:

  POST https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media

Header HTTP yang digunakan saat melakukan upload sederhana meliputi:

  • Content-Type. Setel ke salah satu jenis data media yang diperbolehkan metode.
  • Content-Length. Setel ke jumlah byte yang Anda upload. Tidak diperlukan jika Anda menggunakan potongan encoding transfer.

Upload multibagian

Jika memiliki metadata yang akan dikirim dengan data yang akan diupload, Anda dapat membuat permintaan multipart/related. Ini adalah pilihan yang bagus jika data yang Anda kirim cukup kecil untuk diupload lagi, jika perlu.

Untuk menggunakan upload multibagian, buat permintaan POST atau PUT ke URI /upload pada metode dan tambahkan parameter kueri uploadType=multipart. Contoh:

  POST https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart

Header HTTP tingkat atas yang digunakan saat membuat permintaan upload multibagian mencakup:

  • Content-Type. Setel ke multipart/related dan sertakan string batas yang Anda gunakan untuk mengidentifikasi bagian permintaan.
  • Content-Length. Setel ke jumlah total byte dalam isi permintaan. Bagian media dari permintaan harus kurang dari ukuran file maksimum yang ditentukan untuk metode ini.

Isi permintaan diformat sebagai jenis konten multipart/related [RFC2387] dan berisi tepat dua bagian. Bagian-bagian tersebut diidentifikasi oleh string batas, dan string batas akhir diikuti oleh dua tanda hubung.

Setiap bagian dari permintaan multibagian memerlukan header Content-Type tambahan:

  1. Bagian metadata: Harus didahulukan, dan Content-Type harus cocok dengan salah satu format metadata yang diterima.
  2. Bagian media: Harus ada di urutan kedua, dan Content-Type harus cocok dengan salah satu jenis MIME media metode yang diperbolehkan.

Contoh

Anda mengupload media menggunakan Display & Video 360 API untuk melakukan berbagai tugas. Bagian ini memberikan contoh sebagai permintaan curl.

Upload aset materi iklan

Berikut cara mengupload aset materi iklan:

curl --request POST \
  'https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart' \
  --header 'Authorization: Bearer access-token' \
   -F "data={\"filename\": \"asset-filename\"};type=application/json;charset=UTF-8" \
   -F "file=@asset-path;type=asset-mime-type"

Lihat panduan Mengupload aset materi iklan untuk mengetahui detail selengkapnya dan contoh kode.

Mengupload file skrip bidding kustom

Berikut cara mengupload file skrip:

curl --request POST \
  'https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media' \
  -H 'authorization: Bearer access-token' \
  -H 'Content-Type: text/plain' \
  --data-binary @script-path

Lihat panduan Skrip upload untuk mengetahui detail dan contoh kode selengkapnya.