LiveBroadcasts

API artık canlı yayınlarınızı "çocuklara özel" olarak işaretleme özelliğini destekliyor. Ayrıca liveBroadcast kaynağı, söz konusu canlı yayının "çocuklara özel" durumunu tanımlayan bir özellik içeriyor. YouTube API Hizmetleri Hizmet Şartları ve Geliştirici Politikaları da 10 Ocak 2020'de güncellendi. Daha fazla bilgi için YouTube Canlı Akış API Hizmeti ve YouTube API Servisleri Hizmet Şartları'nın düzeltme geçmişlerine bakın.

liveBroadcast kaynağı, YouTube'da canlı video kullanılarak yayınlanacak bir etkinliği temsil eder.

Yöntemler

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

list
API isteği parametreleriyle eşleşen YouTube yayınlarının listesini döndürür. Hemen deneyin.
insert (ekle)
Yayın oluşturur. Hemen deneyin.
update
Yayınları günceller. Örneğin, liveBroadcast kaynağının contentDetails nesnesinde tanımlanan yayın ayarlarını değiştirebilirsiniz. Hemen deneyin.
delete
Yayınları siler. Hemen deneyin.
bind
YouTube yayınını bir akışa bağlar veya yayın ile akış arasındaki mevcut bağlamayı kaldırır. Bir yayın yalnızca bir video akışına bağlanabilir ancak bir video akışı birden fazla yayına bağlanabilir. Hemen deneyin.
transition
YouTube canlı yayınlarının durumunu değiştirir ve yeni durumla ilişkili tüm süreçleri başlatır. Örneğin, bir yayının durumunu testing olarak değiştirdiğinizde YouTube, videoyu bu yayının monitör akışına iletmeye başlar. Bu yöntemi çağırmadan önce, yayınınızla ilişkili akışın status.streamStatus özelliğinin değerinin active olduğunu onaylamanız gerekir. Hemen deneyin.
cuepoint
Canlı yayına işaret noktası ekler. İşaret noktası, reklam arası tetikleyebilir.

Kaynak temsili

Aşağıdaki JSON yapısı, liveBroadcasts kaynağının biçimini gösterir:

{
  "kind": "youtube#liveBroadcast",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "isDefaultBroadcast": boolean,
    "liveChatId": string
  },
  "status": {
    "lifeCycleStatus": string,
    "privacyStatus": string,
    "recordingStatus": string,
    "madeForKids": string,
    "selfDeclaredMadeForKids": string,
  },
  "contentDetails": {
    "boundStreamId": string,
    "boundStreamLastUpdateTimeMs": datetime,
    "monitorStream": {
      "enableMonitorStream": boolean,
      "broadcastStreamDelayMs": unsigned integer,
      "embedHtml": string
    },
    "enableEmbed": boolean,
    "enableDvr": boolean,
    "recordFromStart": boolean,
    "enableClosedCaptions": boolean,
    "closedCaptionsType": string,
    "projection": string,
    "enableLowLatency": boolean,
    "latencyPreference": boolean,
    "enableAutoStart": boolean,
    "enableAutoStop": boolean,
    "availabilityConfig": {
      "globalConfig": {
        "excludedRegionCodes": [
          string
        ],
        "interval": {
          "startTime": datetime,
          "endTime": datetime
        }
      },
      "regionsConfig": {
        "regionIntervals": [
          {
            "regionCode": string,
            "interval": {
              "startTime": datetime,
              "endTime": datetime
            }
          }
        ]
      }
    }
  },
  "statistics": {
    "totalChatCount": unsigned long
  },
  "monetizationDetails": {
    "adsMonetizationStatus": string,
    "eligibleForAdsMonetization": boolean,
    "cuepointSchedule": {
      "enabled": boolean,
      "pauseAdsUntil": datetime,
      "ytOptimizedCuepointConfig": string,
      "creatorCuepointConfig": {
        "scheduleStrategy": string,
        "repeatIntervalSecs": unsigned integer
      }
    }
  }
}

Özellikler

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

Özellikler
kind string
API kaynağının türünü tanımlar. Değer youtube#liveBroadcast olur.
etag etag
Bu kaynağın ETag'i.
id string
YouTube'un yayını benzersiz şekilde tanımlamak için atadığı kimlik.
snippet object
snippet nesnesi, başlık, açıklama, başlangıç zamanı ve bitiş zamanı gibi etkinlikle ilgili temel ayrıntıları içerir.
snippet.publishedAt datetime
Yayının YouTube'un canlı yayın programına eklendiği tarih ve saat. Değer, ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) biçiminde belirtilir.
snippet.channelId string
YouTube'un yayını yayınlayan kanalı benzersiz şekilde tanımlamak için kullandığı kimlik.
snippet.title string
Yayın başlığı. Yayın, tam olarak bir YouTube videosunu temsil eder. Bu alanı yayın kaynağını değiştirerek veya ilgili video kaynağının title alanını ayarlayarak belirleyebilirsiniz.
snippet.description string
Yayın açıklaması. title alanında olduğu gibi, yayın kaynağını değiştirerek veya ilgili video kaynağının title alanını ayarlayarak bu alanı belirleyebilirsiniz.description
snippet.thumbnails object
Yayınla ilişkili küçük resimlerin haritası. Bu nesnedeki her bir iç içe yerleştirilmiş nesne için anahtar, küçük resmin adıdır ve değer, küçük resimle ilgili diğer bilgileri içeren bir nesnedir.
snippet.thumbnails.(key) object
Geçerli anahtar değerleri:
  • default: Varsayılan küçük resim. Bir video veya videoya referans veren bir kaynak (ör. oynatma listesi öğesi ya da arama sonucu) için varsayılan küçük resim 120 piksel genişliğinde ve 90 piksel yüksekliğindedir. Bir kanalın varsayılan küçük resmi 88 piksel genişliğinde ve 88 piksel yüksekliğindedir.
  • medium: Küçük resmin daha yüksek çözünürlüklü bir sürümü. Video (veya videoya atıfta bulunan bir kaynak) için bu resim 320 piksel genişliğinde ve 180 piksel yüksekliğindedir. Kanallar için bu resim 240 piksel genişliğinde ve 240 piksel yüksekliğindedir.
  • high – Küçük resmin yüksek çözünürlüklü sürümü. Video (veya videoya atıfta bulunan bir kaynak) için bu resim 480 piksel genişliğinde ve 360 piksel yüksekliğindedir. Kanallar için bu resim 800 piksel genişliğinde ve 800 piksel yüksekliğindedir.
snippet.thumbnails.(key).url string
Resmin URL'si.
snippet.thumbnails.(key).width unsigned integer
Resmin genişliği.
snippet.thumbnails.(key).height unsigned integer
Resmin yüksekliği.
snippet.scheduledStartTime datetime
Yayın için planlanan başlangıç tarihi ve saati. Değer, ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) biçiminde belirtilir. Creator Studio, başlangıç zamanı planlamadan yayın oluşturma özelliğini destekler. Bu durumda, kanal sahibi yayını başlattığında yayın da başlar. Bu yayınlar için datetime değeri, Unix döneminin başlangıç zamanına karşılık gelir ve bu değer, API veya Creator Studio kullanılarak değiştirilemez.
snippet.scheduledEndTime datetime
Yayın planının sona ereceği tarih ve saat. Değer, ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) biçiminde belirtilir. Bir liveBroadcast kaynağı bu özellik için değer belirtmezse yayın süresiz olarak devam edecek şekilde planlanır. Benzer şekilde, bu özellik için bir değer belirtmezseniz YouTube, yayını süresiz olarak devam edecekmiş gibi değerlendirir.
snippet.actualStartTime datetime
Yayınların gerçekten başladığı tarih ve saat. Bu bilgiler yalnızca yayın durumu live olduğunda kullanılabilir. Değer, ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) biçiminde belirtilir.
snippet.actualEndTime datetime
Yayının gerçekten sona erdiği tarih ve saat. Bu bilgiler yalnızca yayın durumu complete olduğunda kullanılabilir. Değer, ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) biçiminde belirtilir.
snippet.isDefaultBroadcast boolean
Bu özelliğin desteği 1 Eylül 2020'den itibaren sonlandırılacak. Bu tarihten itibaren YouTube, bir kanalda canlı yayın etkinleştirildiğinde varsayılan yayın ve varsayılan canlı yayın oluşturmayı durduracak. Daha fazla bilgi için desteği sonlandırma duyurusuna bakın.
Bu özellik, yayının varsayılan yayın olup olmadığını gösterir.

Varsayılan yayınlar nasıl çalışır?

Bir YouTube kanalında canlı yayın etkinleştirildiğinde YouTube, kanal için varsayılan bir akış ve varsayılan bir yayın oluşturur. Akış, kanal sahibinin YouTube'a canlı video gönderme şeklini tanımlar. Yayın ise izleyicilerin varsayılan akışı görme şeklidir. Kanal sahibi, bu kaynakları belirlemek için liveStreams.list ve liveBroadcasts.list yöntemlerini kullanabilir.

Bir kanal, varsayılan yayınına video aktarmaya başladığında video, kanalın varsayılan yayınında görünür. Yayın sona erdiğinde YouTube, tamamlanan yayını YouTube videosuna dönüştürür ve videoya bir YouTube video kimliği atar.

Dönüşüm tamamlandıktan sonra video, kanalın yüklenen videolar listesine eklenir. Video, yayın sona erdikten hemen sonra kullanılamaz. Gecikme süresi, yayının gerçek süresiyle ilgilidir.
snippet.liveChatId string
Yayın için YouTube canlı sohbetinin kimliği. Bu kimlikle, sohbet mesajlarını almak, eklemek veya silmek için liveChatMessage kaynağının yöntemlerini kullanabilirsiniz. Ayrıca sohbet moderatörleri ekleyebilir veya kaldırabilir, kullanıcıların canlı sohbetlere katılmasını engelleyebilir ya da mevcut engelleri kaldırabilirsiniz.
status object
status nesnesi, etkinliğin durumuyla ilgili bilgileri içerir.
status.lifeCycleStatus string
Yayın durumu. Durum, API'nin liveBroadcasts.transition yöntemi kullanılarak güncellenebilir.

Bu özelliğin geçerli değerleri şunlardır:
  • complete: Yayın sona erdi.
  • created: Yayın ayarları eksik olduğundan live veya testing durumuna geçmeye hazır değil ancak oluşturuldu ve başka bir sorun yok.
  • live: Yayın etkin.
  • liveStarting: Yayın, live durumuna geçiş yapıyor.
  • ready: Yayın ayarları tamamlanmıştır ve yayın live veya testing durumuna geçebilir.
  • revoked – Bu yayın, bir yönetici işlemiyle kaldırıldı.
  • testStarting: Yayın, testing durumuna geçiş yapıyor.
  • testing: Yayın yalnızca iş ortağı tarafından görülebilir.
status.privacyStatus string
Yayın gizlilik durumu. Yayın, tam olarak bir YouTube videosunu temsil ettiğinden gizlilik ayarları, videolar için desteklenenlerle aynıdır. Ayrıca, yayın kaynağını değiştirerek veya ilgili video kaynağının privacyStatus alanını ayarlayarak da bu alanı belirleyebilirsiniz.

Bu özellik için geçerli değerler şunlardır:
  • private
  • public
  • unlisted
status.recordingStatus string
Yayın kaydının durumu.

Bu özelliğin geçerli değerleri şunlardır:
  • notRecording
  • recorded
  • recording
status.madeForKids boolean
Bu değer, yayının çocuklara yönelik olarak değerlendirilip değerlendirilmediğini gösterir. Bu özellik değeri salt okunurdur.
status.selfDeclaredMadeForKids boolean
Bu mülk, bir liveBroadcasts.insert isteğinde kanal sahibinin yayını çocuklara yönelik olarak belirlemesine olanak tanır. liveBroadcasts.list isteğinde, özellik değeri yalnızca kanal sahibi API isteğini yetkilendirdiyse döndürülür.
contentDetails object
contentDetails nesnesi, etkinliğin video içeriğiyle ilgili bilgileri (ör. içeriğin yerleştirilmiş bir video oynatıcıda gösterilip gösterilemeyeceği veya arşivlenip arşivlenmeyeceği ve dolayısıyla etkinlik sona erdikten sonra görüntülenip görüntülenemeyeceği) içerir.
contentDetails.boundStreamId string
Bu değer, yayına bağlı live stream öğesini benzersiz şekilde tanımlar.
contentDetails.boundStreamLastUpdateTimeMs datetime
boundStreamId tarafından referans verilen canlı yayının en son güncellendiği tarih ve saat.
contentDetails.monitorStream object
monitorStream nesnesi, yayıncının yayın akışı herkese açık olarak gösterilmeden önce etkinlik içeriğini incelemek için kullanabileceği, izleme akışıyla ilgili bilgileri içerir.
contentDetails.monitorStream.enableMonitorStream boolean
Bu değer, yayında izleme akışının etkinleştirilip etkinleştirilmeyeceğini belirler. İzleme yayını etkinleştirilirse YouTube, etkinlik içeriğini yalnızca yayıncının izlemesi için özel olarak tasarlanmış bir yayında yayınlar. Yayıncı, etkinlik içeriğini incelemek ve işaret noktaları eklemek için en uygun zamanları belirlemek üzere akışı kullanabilir.

Yayınınıza testing aşaması eklemek veya etkinliğinizde yayın gecikmesi kullanmak istiyorsanız bu değeri true olarak ayarlamanız gerekir. Ayrıca, bu özelliğin değeri true ise yayınınızı live durumuna geçirmeden önce testing durumuna geçirmeniz gerekir. (Özelliğin değeri false ise yayınınızda testing aşaması olamaz. Bu nedenle, yayını doğrudan live durumuna geçirebilirsiniz.)

update a broadcast işlemi yaptığınızda, API isteğiniz part parametre değerinde contentDetails bölümünü içeriyorsa bu özellik ayarlanmalıdır. Ancak insert a broadcast işlemi yaptığınızda özellik isteğe bağlıdır ve varsayılan değeri true olur.

Önemli: Yayın testing veya live durumundayken bu özellik güncellenemez.
contentDetails.monitorStream.broadcastStreamDelayMs unsigned integer
enableMonitorStream özelliğini true olarak ayarladıysanız bu özellik, canlı yayın gecikmesinin süresini belirler.

update a broadcast işlemi yaptığınızda, API isteğiniz part parametre değerinde contentDetails bölümünü içeriyorsa bu özellik ayarlanmalıdır. Ancak insert a broadcast işlemi yaptığınızda özellik isteğe bağlıdır ve varsayılan değeri 0 olur. Bu değer, yayında yayın gecikmesi olmadığını gösterir. Not: Yayın testing veya live durumundayken bu özellik güncellenemez.
contentDetails.monitorStream.embedHtml string
İzleme akışını oynatan bir oynatıcıyı yerleştiren HTML kodu.
contentDetails.enableEmbed boolean
Bu ayar, yayınlanan videonun yerleştirilmiş bir oynatıcıda oynatılıp oynatılamayacağını gösterir. Videoyu arşivlemeyi seçerseniz (enableArchive özelliğini kullanarak) bu ayar, arşivlenen video için de geçerli olur.

update a broadcast işlemi yaptığınızda, API isteğiniz part parametre değerinde contentDetails bölümünü içeriyorsa bu özellik ayarlanmalıdır. Ancak insert a broadcast işlemi yaptığınızda özellik isteğe bağlıdır ve varsayılan değeri true olur.

Not: Yayın testing veya live durumundayken bu özellik güncellenemez.
contentDetails.enableDvr boolean
Bu ayar, izleyicilerin videoyu izlerken DVR kontrollerine erişip erişemeyeceğini belirler. DVR kontrolleri, izleyicinin içeriği duraklatarak, geri sararak veya hızlı ileri sararak video oynatma deneyimini kontrol etmesini sağlar. Bu özelliğin varsayılan değeri true'dır.

update a broadcast işlemi yaptığınızda, API isteğiniz part parametre değerinde contentDetails bölümünü içeriyorsa bu özellik ayarlanmalıdır. Ancak insert a broadcast işlemi yaptığınızda özellik isteğe bağlıdır ve varsayılan değeri true olur.

Önemli: Oynatmanın yayın bittikten hemen sonra kullanılabilmesini istiyorsanız değeri true olarak ayarlamanız ve enableArchive özelliğinin değerini de true olarak ayarlamanız gerekir. Ayrıca, yayın testing veya live durumundayken bu özellik güncellenemez.
contentDetails.recordFromStart boolean
Bu ayar, etkinliğin durumu "canlı" olarak değiştirildikten sonra YouTube'un yayını otomatik olarak kaydetmeye başlayıp başlamayacağını gösterir.

Bu özelliğin varsayılan değeri true'dir ve yalnızca yayın kanalının canlı yayınlarda kayıtları devre dışı bırakmasına izin veriliyorsa false olarak ayarlanabilir.

Kanalınızın kayıtları devre dışı bırakma izni yoksa ve recordFromStart özelliği false olarak ayarlanmış bir yayın eklemeye çalışırsanız API, Forbidden hatası döndürür. Ayrıca, kanalınızda bu izin yoksa ve bir yayını güncelleyerek recordFromStart özelliğini false olarak ayarlamaya çalışırsanız API modificationNotAllowed hatası döndürür.

update a broadcast işlemi yaptığınızda, API isteğiniz part parametre değerinde contentDetails bölümünü içeriyorsa bu özellik ayarlanmalıdır. Ancak insert a broadcast işlemi yaptığınızda özellik isteğe bağlıdır ve varsayılan değeri true olur.

Önemli: Oynatmanın yayın bittikten hemen sonra kullanılabilmesini istiyorsanız enableDvr özelliğinin değerini true olarak da ayarlamanız gerekir. Bu özelliğin değerini true olarak ayarlarsanız ancak enableDvr özelliğini de true olarak ayarlamazsanız arşivlenen videonun oynatılabilmesi için yaklaşık bir gün beklemeniz gerekebilir.

Not: Yayın testing veya live durumundayken bu özellik güncellenemez.
contentDetails.enableClosedCaptions boolean
Bu özelliğin desteği 17 Aralık 2015'ten itibaren sonlandırıldı. Bunun yerine contentDetails.closedCaptionsType özelliğini kullanın.

Bu ayar, bu yayında HTTP POST altyazılarının etkin olup olmadığını gösterir. Bu mülkü zaten kullanan API istemcileri için:
  • Özellik değerini true olarak ayarlamak, contentDetails.closedCaptionsType özelliğini closedCaptionsHttpPost olarak ayarlamaya eşdeğerdir.
  • Özellik değerini false olarak ayarlamak, contentDetails.closedCaptionsType özelliğini closedCaptionsDisabled olarak ayarlamaya eşdeğerdir.
contentDetails.closedCaptionsType string
Not: Bu özellik, contentDetails.enableClosedCaptions özelliğinin yerini alır.

Bu özellik, yayınınızda altyazıların etkin olup olmadığını ve etkinse hangi tür altyazılar sağladığınızı gösterir:
  • closedCaptionsDisabled: Canlı yayında altyazılar devre dışıdır.
  • closedCaptionsHttpPost: Altyazıları, canlı yayınınızla ilişkili bir alma URL'sine HTTP POST kullanarak gönderirsiniz.
  • closedCaptionsEmbedded: Altyazılar, EIA-608 ve/veya CEA-708 biçimleri kullanılarak video akışında kodlanır.
contentDetails.projection string
Bu yayının projeksiyon biçimi. Özelliğin varsayılan değeri rectangular.

Bu özellik için geçerli değerler şunlardır:
  • 360
  • rectangular
contentDetails.enableLowLatency boolean
Bu yayının düşük gecikmeli akış için kodlanıp kodlanmayacağını gösterir. Düşük gecikmeli akış, yayını izleyen kullanıcıların videoyu görmesi için gereken süreyi azaltabilir ancak akışın izleyiciler için çözünürlüğünü de etkileyebilir.
contentDetails.latencyPreference string
Bu yayın için hangi gecikme ayarının kullanılacağını gösterir. Bu özellik, ultraLow'yi desteklemeyen enableLowLatency yerine kullanılabilir.

Düşük gecikmeli yayın, videonun yayını izleyen kullanıcılara görünmesi için gereken süreyi azaltabilir ancak oynatmanın sorunsuzluğunu da etkileyebilir.

Ultra düşük gecikmeli yayın, videonun izleyicilere görünmesi için gereken süreyi daha da azaltarak izleyicilerle etkileşimi kolaylaştırır ancak ultra düşük gecikme, altyazıları veya 1080p'den yüksek çözünürlükleri desteklemez.

Bu özelliğin geçerli değerleri şunlardır:
  • normal
  • low
  • ultraLow
contentDetails.enableAutoStart boolean
Bu yayının, bağlı live stream cihazında video yayını yapmaya başladığınızda otomatik olarak başlatılıp başlatılmayacağını belirtir.
contentDetails.enableAutoStop boolean
Bu yayının, kanal sahibi bağlı video akışında video akışı yapmayı durdurduktan yaklaşık bir dakika sonra otomatik olarak durdurulup durdurulmayacağını gösterir.
contentDetails.availabilityConfig object
Yayınla ilgili kullanılabilirlik yapılandırması. Belirli bir bölgedeki stok durumunu ayarlamak veya belirli bölgeleri engellemek için kullanılır. İsteğe bağlıdır. Ayarlanmazsa zorunlu tutulmaz.
contentDetails.availabilityConfig.globalConfig object
Yayın için dünya genelinde kullanılabilirlik yapılandırması. Video, excludedRegionCodes listesinde belirtilenler hariç tüm bölgelerde kullanılabilir.
contentDetails.availabilityConfig.globalConfig.excludedRegionCodes list (string)
Videonun engellendiği bölgelerin listesi.
contentDetails.availabilityConfig.globalConfig.interval object
Videonun engellenmemiş tüm bölgelerde kullanılabildiği varsayılan zaman aralığı. Not: Bu özellik, yaklaşan veya etkin canlı yayınlarda desteklenmez.
contentDetails.availabilityConfig.globalConfig.interval.startTime datetime
Videonun kullanıma sunulacağı tarih ve saat. Belirtilmezse video zaten kullanılabilir. Değer, ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) biçiminde belirtilir.
contentDetails.availabilityConfig.globalConfig.interval.endTime datetime
Videonun kullanılamaz hale geleceği tarih ve saat. Belirtilmezse video süresiz olarak kullanılabilir. Belirtilen başlangıç ve bitiş zamanları, beş yıldan daha uzun bir süre sonra olamaz. Değer, ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) biçiminde belirtilir.
contentDetails.availabilityConfig.regionsConfig object
Yayın için bölgesel kullanılabilirlik yapılandırması. Video yalnızca belirtilen bölgelerde kullanılabilir.
contentDetails.availabilityConfig.regionsConfig.regionIntervals list (object)
Videonun kullanılabildiği bölgelerin ve zaman aralıklarının listesi. Bir bölge birden çok kez belirtilirse tüm aralıkların birleşimi kullanılır.
contentDetails.availabilityConfig.regionsConfig.regionIntervals.regionCode string
Videonun kullanılabildiği bölge.
contentDetails.availabilityConfig.regionsConfig.regionIntervals.interval object
Videonun belirtilen bölgede kullanılabildiği zaman aralığı. Not: Bu özellik, yaklaşan veya etkin canlı yayınlarda desteklenmez.
contentDetails.availabilityConfig.regionsConfig.regionIntervals.interval.startTime datetime
Videonun belirtilen bölgede kullanıma sunulduğu tarih ve saat. Belirtilmezse video zaten kullanılabilir. Değer, ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) biçiminde belirtilir.
contentDetails.availabilityConfig.regionsConfig.regionIntervals.interval.endTime datetime
Videonun belirtilen bölgede kullanılamaz hale geldiği tarih ve saat. Belirtilmezse video süresiz olarak kullanılabilir. Belirtilen başlangıç ve bitiş zamanları, beş yıldan daha uzun bir süre sonra olamaz. Değer, ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) biçiminde belirtilir.
statistics object
statistics nesnesi, canlı yayınla ilgili istatistikleri içerir. Bu istatistiklerin değerleri yayın sırasında değişebilir ve yalnızca yayın devam ederken alınabilir.
statistics.totalChatCount unsigned long
Yayınla ilişkili toplam canlı sohbet mesajı sayısıdır. Yayın kullanıcı tarafından görülebiliyorsa, canlı sohbet özelliği etkinse ve yayında en az bir mesaj varsa mülk ve değeri gösterilir. Bu özelliğin, yayın sona erdikten sonra değer belirtmeyeceğini unutmayın. Bu nedenle, bu özellik tamamlanmış bir canlı yayının arşivlenmiş videosundaki sohbet mesajlarının sayısını belirleyemez.
monetizationDetails object
monetizationDetails nesnesi, akışın para kazanma ayrıntılarıyla ilgili bilgileri (ör. reklam otomasyonunun etkin olup olmadığı veya orta rulo reklam eklemenin gecikip gecikmediği) içerir.

monetizationDetails.adsMonetizationStatus string
Bu özellik, bir video yayınında videonun ortasında gösterilen reklamların etkin olup olmadığını gösterir. Geçerli değerler on ve off'dir.
monetizationDetails.eligibleForAdsMonetization string
Bu özellik, bir video yayınının videonun ortasında gösterilen reklamlar için uygun olup olmadığını gösterir. Yayınlar, mevcut bir hak talebi veya kanalın para kazanmaya uygun olmaması gibi çeşitli nedenlerle uygun olmayabilir.
monetizationDetails.cuepointSchedule object
cuepointSchedule nesnesi, yayının reklam otomasyonu ayarlarını belirtir.
monetizationDetails.cuepointSchedule.enabled boolean
Bu değer, yayınlara reklamların otomatik olarak eklenip eklenmeyeceğini belirler. Değer true ise YouTube, yayına otomatik olarak ara reklamlar ekler. Reklam yayınlama planı, monetizationDetails.cuepointSchedule nesnesindeki diğer alanların değerine göre belirlenir.
monetizationDetails.cuepointSchedule.pauseAdsUntil datetime
Bu değer, YouTube'un belirtilen tarih ve saate kadar yayına videonun ortasında gösterilen reklamlar eklememesi gerektiğini belirtir. Değer, ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) biçiminde belirtilir. Reklamları duraklatmak için değer gelecekteki bir tarih ve saat olarak ayarlanmalıdır. Reklamları yeniden başlatmak için alan değeri geçmişteki bir tarih ve saat veya boş bir değer olarak da ayarlanabilir.
monetizationDetails.cuepointSchedule.ytOptimizedCuepointConfig string
Bu alan, otomatik olarak eklenen reklam işaret noktaları için seçilen seçeneği belirtir. Alan, üç moddan birini belirtebilir:
  • LOW: Daha düşük kazanç potansiyeli, izleyiciler için daha kesintisiz deneyim
  • MEDIUM: Orta düzeyde kazanç potansiyeli, dengeli izleyici deneyimi
  • HIGH: Daha yüksek kazanç potansiyeli, izleyiciler için daha kesintili deneyim
monetizationDetails.cuepointSchedule.creatorCuepointConfig object
creatorCuepointConfig nesnesi, ara reklamların nasıl görüneceğini seçmesine olanak tanıyan reklam otomasyonu seçeneğini belirtir.
monetizationDetails.cuepointSchedule.creatorCuepointConfig.scheduleStrategy string
Bu değer, YouTube'un işaret noktalarını planlarken izlemesi gereken stratejiyi belirtir. Geçerli değerler:
  • CONCURRENT: İşaret noktaları, tüm izleyiciler için aynı anda planlanır.
  • NON_CONCURRENT: Cuepoint'ler farklı izleyiciler için farklı zamanlarda planlanır. Bu yaklaşım, reklamların daha yüksek bir sıklıkta gösterilmesini sağlayarak izleyicilerin uygun olduğunda işaret noktaları almasına olanak tanır.
monetizationDetails.cuepointSchedule.creatorCuepointConfig.repeatIntervalSecs unsigned integer
Bu değer, yayın sırasında otomatik reklam ekleme arasındaki aralığı saniye cinsinden belirtir. Örneğin, değer 360 ise YouTube, altı dakikalık aralıklarla videonun ortasında gösterilen reklam işaret noktaları ekleyebilir.

Not:
  • Değer, ardışık işaret noktalarının başlangıcı arasındaki süreyi belirtir. Yani aralık, bir ipucu noktasının sonundan bir sonrakinin başlangıcına kadar ölçülmez.
  • YouTube Studio ayarlarıyla tutarlı olması için bu değer, 6 dakikadan 30 dakikaya kadar 6 dakikanın katları şeklinde belirlenir. Bu aralıktaki güncelleme isteğinde yer alan tüm tam sayılar geçerli olsa da 6 dakikanın en yakın katına yuvarlanır.