LiveBroadcasts: update

Bir yayını günceller. Örneğin, liveBroadcast kaynağının contentDetails nesnesinde tanımlanan yayın ayarlarını değiştirebilirsiniz.

Yaygın kullanım örnekleri

İstek

HTTP isteği

PUT https://www.googleapis.com/youtube/v3/liveBroadcasts

Yetkilendirme

Bu istek, aşağıdaki kapsamların en az biriyle yetkilendirme gerektiriyor. Kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi edinmek için OAuth 2.0 yetkilendirmesini uygulama başlıklı makaleyi inceleyin.

Kapsam
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parametreler

Aşağıdaki tabloda, bu sorgunun desteklediği parametreler listelenmiştir. Listelenen tüm parametreler sorgu parametreleridir.

Parametreler
Gerekli parametreler
part string
part parametresi bu işlemde iki amaç için kullanılır. Yazma işleminin ayarlayacağı özelliklerin yanı sıra API yanıtının içereceği özellikleri tanımlar.

Parametre değerine dahil edebileceğiniz part özellikleri id, snippet, contentDetails, monetizationDetails ve status'dir.

Bu yöntemin, parametre değerinin belirttiği tüm kısımlarda bulunan tüm değiştirilebilir özelliklerin mevcut değerlerini geçersiz kılacağını unutmayın. Örneğin, bir yayının gizlilik durumu status bölümünde tanımlanır. Bu nedenle, isteğiniz özel veya liste dışı bir yayını güncelliyorsa ve isteğin part parametre değeri status bölümünü içeriyorsa yayının gizlilik ayarı, istek gövdesinin belirttiği değerle güncellenir. İstek gövdesinde bir değer belirtilmezse mevcut gizlilik ayarı kaldırılır ve yayın varsayılan gizlilik ayarına geri döner.
İsteğe bağlı parametreler
onBehalfOfContentOwner string
Bu parametre yalnızca uygun şekilde yetkilendirilmiş bir istekte kullanılabilir.
Not: Bu parametre yalnızca YouTube içerik iş ortakları için tasarlanmıştır.

onBehalfOfContentOwner parametresi, isteğin yetkilendirme kimlik bilgilerinin, parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube İçerik Yönetim Sistemi (İYS) kullanıcısını tanımladığını gösterir. Bu parametre, birçok farklı YouTube kanalına sahip olan ve bu kanalları yöneten YouTube içerik iş ortakları için tasarlanmıştır. İçerik sahiplerinin, her bir kanal için kimlik doğrulama bilgileri sağlamak zorunda kalmadan bir kez kimliklerini doğrulamalarını ve tüm video ve kanal verilerine erişmelerini sağlar. Kullanıcının kimliğini doğruladığı İYS hesabı, belirtilen YouTube içerik sahibine bağlı olmalıdır.
onBehalfOfContentOwnerChannel string
Bu parametre yalnızca uygun şekilde yetkilendirilmiş bir istekte kullanılabilir.
Not: Bu parametre yalnızca YouTube içerik iş ortakları için tasarlanmıştır.

onBehalfOfContentOwnerChannel parametresi, videonun eklendiği kanalın YouTube kanal kimliğini belirtir. Bir istek onBehalfOfContentOwner parametresi için bir değer belirttiğinde bu parametre gereklidir ve yalnızca bu parametreyle birlikte kullanılabilir. Ayrıca isteğin, onBehalfOfContentOwner parametresinin belirttiği içerik sahibine bağlı bir İçerik Yönetim Sistemi hesabı kullanılarak yetkilendirilmesi gerekir. Son olarak, onBehalfOfContentOwnerChannel parametre değerinin belirttiği kanal, onBehalfOfContentOwner parametresinin belirttiği içerik sahibine bağlı olmalıdır.

Bu parametre, birçok farklı YouTube kanalına sahip olan ve bu kanalları yöneten YouTube içerik iş ortakları için tasarlanmıştır. Bu, içerik sahiplerinin her ayrı kanal için kimlik doğrulama kimlik bilgilerini sağlamaya gerek kalmadan bir kez kimlik doğrulaması yapmalarına ve parametre değerinde belirtilen kanal adına işlem yapmalarına olanak tanır.

İstek içeriği

İstek gövdesinde bir liveBroadcast kaynağı sağlayın. Bu kaynak için:

  • Şu özellikler için bir değer belirtmelisiniz:

    • id
    • snippet.scheduledStartTime
    • contentDetails.monitorStream.enableMonitorStream
    • contentDetails.monitorStream.broadcastStreamDelayMs

  • Aşağıdaki özellikler için değer ayarlayabilirsiniz:

    • snippet.title
    • snippet.description
    • snippet.scheduledStartTime
    • snippet.scheduledEndTime
    • status.privacyStatus
    • contentDetails.monitorStream.enableMonitorStream
    • contentDetails.monitorStream.broadcastStreamDelayMs
    • contentDetails.enableAutoStart
    • contentDetails.enableAutoStop
    • contentDetails.enableClosedCaptions
    • contentDetails.enableDvr
    • contentDetails.enableEmbed
    • contentDetails.recordFromStart
    • monetizationDetails.cuepointSchedule.pauseAdsUntil

    Güncelleme isteği gönderiyorsanız ve isteğinizde, halihazırda değeri olan bir tesis için bir değer belirtilmiyorsa tesisin mevcut değeri silinir.

Yanıt

Başarılı olursa bu yöntem, yanıt gövdesinde bir canlı yayın kaynağı döndürür.

Hatalar

Aşağıdaki tabloda, API'nin bu yönteme yapılan bir çağrıya yanıt olarak döndürebileceği hata mesajları tanımlanmaktadır. Daha fazla bilgi için hata mesajı bölümüne bakın.

Hata türü Hata ayrıntısı Açıklama
forbidden (403) closedCaptionsTypeModificationNotAllowed contentDetails.closedCaptionsType değeri yalnızca yayın created veya ready durumundayken değiştirilebilir.
forbidden (403) enabledModificationNotAllowed enabled alanı salt okunur.
forbidden (403) scheduleStrategyModificationNotAllowed scheduleStrategy alanı salt okunur.
forbidden (403) repeatIntervalSecsModificationNotAllowed repeatIntervalSecs alanı salt okunur.
forbidden (403) pauseAdsUntilModificationNotAllowed pauseAdsUntil alanı değiştirilemez. Bu hata aşağıdaki nedenlerden kaynaklanabilir:
  • monetizationDetails.cuepointSchedule.enabled alanı true olarak ayarlanmamış. Bu alan yalnızca YouTube Studio kullanılarak ayarlanabilir.
  • Yayın canlı değil.
forbidden (403) enableAutoStartModificationNotAllowed contentDetails.enableAutoStart değeri yalnızca akış etkin olmadığında ve yayın created veya ready durumunda olduğunda değiştirilebilir.
forbidden (403) enableClosedCaptionsModificationNotAllowed contentDetails.enableClosedCaptions değeri yalnızca yayının durumu created veya ready olduğunda değiştirilebilir.
forbidden (403) enableDvrModificationNotAllowed contentDetails.enableDvr değeri yalnızca yayının durumu created veya ready olduğunda değiştirilebilir.
forbidden (403) enableMonitorStreamModificationNotAllowed contentDetails.monitorStream.enableMonitorStream değeri yalnızca yayının durumu created veya ready olduğunda değiştirilebilir.
forbidden (403) recordFromStartModificationNotAllowed contentDetails.recordFromStart değeri yalnızca yayının durumu created veya ready olduğunda değiştirilebilir.
insufficientPermissions insufficientLivePermissions İsteğin, belirtilen canlı yayını güncelleme yetkisi yok. Daha fazla bilgi için OAuth2 kimlik doğrulamasını uygulama başlıklı makaleyi inceleyin.
insufficientPermissions liveStreamingNotEnabled İsteğe yetki veren kullanıcının YouTube'da canlı video yayınlama izni yok. Kullanıcı, https://www.youtube.com/features adresinde daha fazla bilgi bulabilir.
invalidValue (400) invalidAutoStart liveBroadcast kaynağı, contentDetails.enableAutoStart özelliği için geçersiz bir değer içeriyordu. Kalıcı bir yayın için enableAutoStart ayarını değiştiremezsiniz.
invalidValue (400) invalidAutoStop liveBroadcast kaynağı, contentDetails.enableAutoStop özelliği için geçersiz bir değer içeriyordu. Kalıcı bir yayın için enableAutoStop ayarını değiştiremezsiniz.
invalidValue (400) invalidDescription canlı yayın kaynağı, snippet.description mülkü için geçerli bir değer belirtmedi. snippet.description en fazla 5.000 karakter içerebilir.
invalidValue (400) invalidEmbedSetting canlı yayın kaynağı, contentDetails.enable_embed mülkü için geçersiz bir değer içeriyordu. Bu yayını yerleştiremezsiniz.
invalidValue (400) invalidEnableClosedCaptions liveBroadcast kaynağında, contentDetails.enableClosedCaptions özelliğinin değeri contentDetails.closedCaptionType ayarının değeriyle uyumlu değil. Kaynağı, yalnızca iki özellikten birini içerecek şekilde değiştirin ve ardından isteği yeniden gönderin.
invalidValue (400) invalidLatencyPreferenceOptions canlı yayın kaynağı, contentDetails.latencyPreference mülkü için geçersiz bir değer içeriyordu. Bu gecikme tercihi bazı ayarlarda desteklenmez.
invalidValue (400) invalidPauseAdsUntil canlıYayın kaynağı, monetizationDetails.cuepointSchedule.pauseAdsUntil özelliği için geçersiz bir değer içeriyor. Bu hata aşağıdaki nedenlerden dolayı ortaya çıkabilir:
  • monetizationDetails.cuepointSchedule.pauseAdsUntil değeri ISO 8601 (YYYY-AA-GGTsa:dk:sn.sZ) biçiminde belirtilmemiştir.
  • monetizationDetails.cuepointSchedule.pauseAdsUntil değeri gelecekte değil.
  • monetizationDetails.cuepointSchedule.pauseAdsUntil değeri, geçerli zamandan 10 dakikadan daha uzakta.
invalidValue (400) invalidPrivacyStatus canlıYayın kaynağı geçerli bir gizlilik durumu belirtmedi. Geçerli privacyStatus değerlerini inceleyin.
invalidValue (400) invalidProjection canlı yayın kaynağı, contentDetails.projection mülkü için geçersiz bir değer içeriyordu. Kalıcı bir yayının projeksiyonu 360 olarak ayarlanamaz.
invalidValue (400) invalidScheduledEndTime canlı yayın kaynağı, snippet.scheduledEndTime mülkü için geçersiz bir değer içeriyordu. Planlanan bitiş zamanı, planlanan başlangıç zamanından sonra olmalıdır.
invalidValue (400) invalidScheduledStartTime canlı yayın kaynağı, snippet.scheduledStartTime mülkü için geçersiz bir değer içeriyordu. Planlanan başlangıç zamanı gelecekte olmalıdır.
invalidValue (400) invalidTitle canlı yayın kaynağı, snippet.title mülkü için geçerli bir değer belirtmedi. snippet.title uzunluğu 1 ile 100 karakter arasında olmalıdır.
notFound (404) liveBroadcastNotFound canlıYayın kaynağında belirtilen id mülkü bir yayın tanımlamadı.
required (400) broadcastStreamDelayMsRequired canlı yayın kaynağı, contentDetails.monitorStream.broadcastStreamDelayMs mülkünü belirtmedi.
required (400) enableMonitorStreamRequired liveBroadcast kaynağı contentDetails.monitorStream.enableMonitorStream özelliğini belirtmedi.
required (400) idRequired canlıYayın kaynağı, id mülkü için bir değer içermeli ve belirtmelidir.
required (400) scheduledEndTimeRequired liveBroadcast kaynağı snippet.scheduledEndTime özelliğini belirtmedi.
required (400) scheduledStartTimeRequired canlı yayın kaynağı, snippet.scheduledStartTime mülkünü belirtmedi.

Deneyin!

Bu API'yi çağırmak ve API isteğini ve yanıtını görmek için APIs Explorer simgesini kullanın.