LiveCuepoints

liveCuepoint kaynağı ve liveCuepoints.insert yöntemi kullanımdan kaldırıldı ve liveBroadcasts.cuepoint yöntemiyle değiştirildi.

liveCuepoint kaynağı, yayın video akışına bir işaret noktası ekler ve reklam arası tetiklenebilir.

Not: Bu API komutu aslında YouTube Content ID API'sinin bir parçasıdır ve liveBroadcast ve liveStream kaynaklarını yönetme isteklerinden farklı yetkilendirme şartlarına sahiptir.

Yöntemler

API, liveCuepoints kaynakları için aşağıdaki yöntemleri destekler:

ekle
Canlı yayına işaret noktası ekler. Şu anda, bu yönteme yapılan istekler YouTube İçerik Sahibi ile ilişkili bir hesap tarafından yetkilendirilmelidir. Hemen deneyin.

Kaynak temsili

Aşağıdaki JSON yapısı, bir liveCuepoints kaynağının biçimini göstermektedir:

{
  "id": string,
  "kind": "youtubePartner#liveCuepoint",
  "broadcastId": string,
  "settings": {
    "offsetTimeMs": long,
    "walltime": datetime,
    "cueType": string,
    "durationSecs": unsigned integer
  }
}

Özellikler

Aşağıdaki tabloda, bu kaynakta görünen özellikler tanımlanmaktadır:

Özellikler
id string
YouTube'un, işaret noktasını benzersiz şekilde tanımlamak için atadığı değer.
kind string
API kaynağının türü. liveCuepoint kaynakları için değer: youtubePartner#liveCuepoint.
broadcastId string
İşaret noktasının eklendiği yayını benzersiz şekilde tanımlamak için YouTube'un atadığı kimlik.
settings object
settings nesnesi, işaret noktasının ayarlarını tanımlar.
settings.offsetTimeMs long
Bu değer, videoda izleyicilerin bir reklamı veya yayın içi seçenek listesini görmesi gereken zamanı belirtir. Özellik değeri, izleme akışının başlangıcından itibaren zaman farkını milisaniye cinsinden tanımlar. Milisaniye cinsinden ölçülse de değer yaklaşık bir değerdir ve YouTube, işaret noktasını o zamana mümkün olduğunca yakın bir şekilde ekler. Yayınınızda izleyici akışı yoksa bu parametre için değer belirtmemelisiniz.

Bu özelliğin varsayılan değeri olan 0, işaret noktasının mümkün olan en kısa sürede eklenmesi gerektiğini gösterir. Yayın akışınız gecikmiyorsa geçerli tek değer de 0 olur. Bununla birlikte, yayın akışınız gecikirse mülk değeri, işaret noktasının ekleneceği zamanı belirtebilir. Daha fazla bilgi için Başlangıç kılavuzuna bakın.

Not: Yayınınızda test aşaması varsa test aşamasının başladığı andan itibaren ofset ölçülür.
settings.walltime datetime
Bu değer, işaret noktasının ekleneceği duvar saati zamanını belirtir. Değer ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ) biçiminde belirtilir.

İstek, bu özellik ve settings.offsetTimeMs özelliği için bir değer belirten işaret noktası eklemeye çalışırsa API bir hata döndürür.
settings.cueType string
İşaret noktasının türü. Farklı işaret noktası türlerinin açıklaması için Başlangıç kılavuzuna bakın. Yayınınız sırasında işaret noktası eklemeyle ilgili en iyi uygulamalar için Yayının ömrü dokümanını da inceleyin.

Bu özellik için geçerli değerler şunlardır:
  • ad
settings.durationSecs unsigned integer
İşaret noktasının saniye cinsinden süresi. cueType değeri ad ise ve aksi takdirde yoksayılırsa bu değer belirtilmelidir.