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,
liveBroadcastkaynağınıncontentDetailsnesnesinde 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
testingolarak 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ışınstatus.streamStatusözelliğinin değerininactiveolduğ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 |
stringAPI kaynağının türünü tanımlar. Değer youtube#liveBroadcast olur. |
etag |
etagBu kaynağın ETag'i. |
id |
stringYouTube'un yayını benzersiz şekilde tanımlamak için atadığı kimlik. |
snippet |
objectsnippet nesnesi, başlık, açıklama, başlangıç zamanı ve bitiş zamanı gibi etkinlikle ilgili temel ayrıntıları içerir. |
snippet.publishedAt |
datetimeYayı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 |
stringYouTube'un yayını yayınlayan kanalı benzersiz şekilde tanımlamak için kullandığı kimlik. |
snippet.title |
stringYayı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 |
stringYayı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 |
objectYayı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) |
objectGeçerli anahtar değerleri:
|
snippet.thumbnails.(key).url |
stringResmin URL'si. |
snippet.thumbnails.(key).width |
unsigned integerResmin genişliği. |
snippet.thumbnails.(key).height |
unsigned integerResmin yüksekliği. |
snippet.scheduledStartTime |
datetimeYayı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 |
datetimeYayı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 |
datetimeYayı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 |
datetimeYayı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 |
stringYayı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 |
objectstatus nesnesi, etkinliğin durumuyla ilgili bilgileri içerir. |
status.lifeCycleStatus |
stringYayın durumu. Durum, API'nin liveBroadcasts.transition yöntemi kullanılarak güncellenebilir.Bu özelliğin geçerli değerleri şunlardır:
|
status.privacyStatus |
stringYayı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:
|
status.recordingStatus |
stringYayın kaydının durumu. Bu özelliğin geçerli değerleri şunlardır:
|
status.madeForKids |
booleanBu değer, yayının çocuklara yönelik olarak değerlendirilip değerlendirilmediğini gösterir. Bu özellik değeri salt okunurdur. |
status.selfDeclaredMadeForKids |
booleanBu 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 |
objectcontentDetails 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 |
stringBu değer, yayına bağlı live stream öğesini benzersiz şekilde tanımlar. |
contentDetails.boundStreamLastUpdateTimeMs |
datetimeboundStreamId tarafından referans verilen canlı yayının en son güncellendiği tarih ve saat. |
contentDetails.monitorStream |
objectmonitorStream 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 |
booleanBu 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 integerenableMonitorStream ö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 |
booleanBu 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 |
booleanBu 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 |
booleanBu 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 |
booleanBu ö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:
|
contentDetails.closedCaptionsType |
stringNot: 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:
|
contentDetails.projection |
stringBu yayının projeksiyon biçimi. Özelliğin varsayılan değeri rectangular.Bu özellik için geçerli değerler şunlardır:
|
contentDetails.enableLowLatency |
booleanBu 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 |
stringBu 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:
|
contentDetails.enableAutoStart |
booleanBu 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 |
booleanBu 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 |
objectYayı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 |
objectYayı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 |
objectVideonun 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 |
datetimeVideonun 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 |
datetimeVideonun 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 |
objectYayı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 |
stringVideonun kullanılabildiği bölge. |
contentDetails.availabilityConfig.regionsConfig.regionIntervals.interval |
objectVideonun 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 |
datetimeVideonun 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 |
datetimeVideonun 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 |
objectstatistics 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 longYayı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 |
objectmonetizationDetails 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 |
stringBu ö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 |
stringBu ö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 |
objectcuepointSchedule nesnesi, yayının reklam otomasyonu ayarlarını belirtir. |
monetizationDetails.cuepointSchedule.enabled |
booleanBu 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 |
datetimeBu 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 |
stringBu alan, otomatik olarak eklenen reklam işaret noktaları için seçilen seçeneği belirtir. Alan, üç moddan birini belirtebilir:
|
monetizationDetails.cuepointSchedule.creatorCuepointConfig |
objectcreatorCuepointConfig 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 |
stringBu değer, YouTube'un işaret noktalarını planlarken izlemesi gereken stratejiyi belirtir. Geçerli değerler:
|
monetizationDetails.cuepointSchedule.creatorCuepointConfig.repeatIntervalSecs |
unsigned integerBu 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:
|