REST Resource: videoAdvertisingOptions

Kaynak: VideoAdvertisingOption

Bir videonun reklam ayarları. Ayarlar, video sırasında yayınlanabilecek reklam türlerinin yanı sıra reklamların video sırasında yayınlanmasına izin verilen zamanları tanımlar.

JSON gösterimi
{
  "kind": string,
  "adFormats": [
    string
  ],
  "breakPosition": [
    string
  ],
  "adBreaks": [
    {
      object (AdBreak)
    }
  ],
  "autoGeneratedBreaks": boolean,
  "id": string,
  "tpAdServerVideoId": string,
  "tpTargetingUrl": string,
  "tpUrlParameters": string
}
Alanlar
kind

string

API kaynağının türü. Bu kaynak için değer: youtubePartner#videoAdvertisingOption.

adFormats[]

string

Videonun gösterilmesine izin verilen reklam biçimlerinin listesidir. Not: Kasım 2023'ten itibaren bu sütunda yalnızca üçüncü_ taraf_reklamlar etkinleştirilebilir veya devre dışı bırakılabilir. Daha fazla bilgi için destek makalesini inceleyin. Şu reklam biçimi kontrolleri artık kullanılamıyor ve API isteğine dahil edilmemelidir: instream_standard, display, preroll, postroll.

breakPosition[]

string

Video oynatma sırasında aranın oluştuğu nokta.

adBreaks[]

object (AdBreak)

YouTube'un video oynatılırken yayın içi reklam gösterebileceği zamanların listesi.

autoGeneratedBreaks

boolean

Otomatik olarak oluşturulan, videonun ortasında gösterilen reklam araları için bu videoyu etkinleştirir.

id

string

YouTube'un reklam ayarlarıyla ilişkilendirilen videoyu benzersiz şekilde tanımlamak için kullandığı kimlik.

tpAdServerVideoId

string

Videoyu üçüncü taraf reklam sunucusuna benzersiz şekilde tanımlayan bir değerdir.

tpTargetingUrl

string

YouTube'un videoya ilişkin yayın içi reklamları alabileceği üçüncü taraf reklam sunucusunun temel URL'si.

tpUrlParameters

string

Üçüncü taraf reklam sunucusuna yapılan isteğin sonuna eklenecek bir parametre dizesi.

AdBreak

adBreak kaynağı, YouTube'un video oynatma sırasında yayın içi reklam gösterebileceği zamanla ilgili bilgiler içerir.

JSON gösterimi
{
  "position": string,
  "midrollSeconds": integer
}
Alanlar
position

string

Video oynatma sırasında aranın oluştuğu nokta.

midrollSeconds

integer

Video başladıktan sonra aranın olduğu saniye sayısı olarak belirtilen reklam arası zamanı.

Yöntemler

get

Belirtilen video için reklam ayarlarını getirir.

getEnabledAds

Belirli bir iş ortağı veya kullanıcı tarafından yüklenen video için izin verilen reklam türleriyle ilgili ayrıntıları alır.

patch

Belirtilen video için reklam ayarlarına yama uygular.

update

Belirtilen video için reklam ayarlarını günceller.