REST Resource: videoAdvertisingOptions

Kaynak: VideoAdvertisingOption

Videonun reklamcılık ayarları. Ayarlar, video sırasında yayınlanabilecek reklam türlerini ve video sırasında reklamların yayınlanmasına izin verilen zamanları belirler.

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 kaynağın değeri youtubePartner#videoAdvertisingOption.

adFormats[]

string

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

breakPosition[]

string

Video oynatılırken aranın meydana geldiği 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 aralar için bu videoyu etkinleştirir.

id

string

YouTube'un reklamcılık 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ğer.

tpTargetingUrl

string

YouTube'un video için 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 parametre dizesi.

AdBreak

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

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

string

Video oynatılırken aranın meydana geldiği nokta.

midrollSeconds

integer

Video başlangıcından sonra aranın gerçekleştiği saniye sayısı olarak belirtilen reklam arası süresi.

Yöntemler

get

Belirtilen video için reklam ayarlarını alır.

getEnabledAds

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

patch

Belirtilen videonun reklamcılık ayarlarına yama uygular.

update

Belirtilen videonun reklamcılık ayarlarını günceller.