REST Resource: videoAdvertisingOptions

Referensi: VideoAdvertisingOption

Setelan iklan untuk video. Setelan ini mengidentifikasi jenis iklan yang dapat dijalankan selama pemutaran video, serta waktu yang diizinkan untuk menjalankan iklan selama video diputar.

Representasi JSON
{
  "kind": string,
  "adFormats": [
    string
  ],
  "breakPosition": [
    string
  ],
  "adBreaks": [
    {
      object (AdBreak)
    }
  ],
  "autoGeneratedBreaks": boolean,
  "id": string,
  "tpAdServerVideoId": string,
  "tpTargetingUrl": string,
  "tpUrlParameters": string
}
Kolom
kind

string

Jenis resource API. Untuk resource ini, nilainya adalah youtubePartner#videoAdvertisingOption.

adFormats[]

string

Daftar format iklan yang mengizinkan video untuk ditampilkan. Catatan: mulai November 2023, hanya iklan_pihak ketiga yang dapat diaktifkan/dinonaktifkan di kolom ini. Lihat artikel dukungan untuk informasi selengkapnya. Kontrol format iklan berikut tidak lagi tersedia dan tidak boleh disertakan dalam permintaan API: instream_standard, display, preroll, postroll.

breakPosition[]

string

Titik saat jeda terjadi selama pemutaran video.

adBreaks[]

object (AdBreak)

Daftar waktu saat YouTube dapat menampilkan iklan in-stream selama pemutaran video.

autoGeneratedBreaks

boolean

Mengaktifkan video ini untuk jeda iklan mid-roll yang dibuat secara otomatis.

id

string

ID yang digunakan YouTube untuk mengidentifikasi secara unik video yang terkait dengan setelan iklan.

tpAdServerVideoId

string

Nilai yang mengidentifikasi video ke server iklan pihak ketiga secara unik.

tpTargetingUrl

string

URL dasar untuk server iklan pihak ketiga tempat YouTube dapat mengambil iklan in-stream untuk video.

tpUrlParameters

string

String parameter yang akan ditambahkan ke akhir permintaan ke server iklan pihak ketiga.

AdBreak

Referensi adBreak berisi informasi tentang waktu saat YouTube dapat menampilkan iklan in-stream selama pemutaran video.

Representasi JSON
{
  "position": string,
  "midrollSeconds": integer
}
Kolom
position

string

Titik saat jeda terjadi selama pemutaran video.

midrollSeconds

integer

Waktu jeda iklan ditentukan sebagai jumlah detik setelah video dimulai saat jeda terjadi.

Metode

get

Mengambil setelan iklan untuk video yang ditentukan.

getEnabledAds

Mengambil detail tentang jenis iklan yang diizinkan untuk video yang diupload pengguna atau partner tertentu.

patch

Menerapkan patch pada setelan iklan untuk video yang ditentukan.

update

Memperbarui setelan iklan untuk video yang ditentukan.