LiveStreams: update

Video akışını günceller. Değiştirmek istediğiniz özellikler güncellenemiyorsa doğru ayarlarla yeni bir akış oluşturmanız gerekir.

Yaygın kullanım örnekleri

İstek

HTTP isteği

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

Yetkilendirme

Bu istek, aşağıdaki kapsamlardan en az birinde 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, cdn 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. İstek gövdesinde, değiştirilebilir bir özellik için değer belirtilmezse söz konusu özelliğin mevcut değeri kaldırılır.
İ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 içerik yönetim sistemi 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. Bu sayede içerik sahipleri, her kanal için kimlik doğrulama kimlik bilgilerini sağlamak zorunda kalmadan tek seferde kimlik doğrulama yapabilir ve tüm video ve kanal verilerine erişebilir. 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, istek için onBehalfOfContentOwner parametresinin belirttiği içerik sahibine bağlı bir İYS hesabı kullanılarak yetkilendirme yapılmalıdır. 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 liveStream kaynağı sağlayın. Bu kaynak için:

  • Aşağıdaki özellikler için bir değer belirtmeniz gerekir:

    • id
    • snippet.title
    • cdn.frameRate
    • cdn.ingestionType
    • cdn.resolution

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

    • snippet.title
    • snippet.description

    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 YouTube Live Streaming API - Errors başlıklı makaleyi inceleyin.

Hata türü Hata ayrıntısı Açıklama
forbidden (403) liveStreamModificationNotAllowed Belirtilen canlı yayın, mevcut durumundayken değiştirilemez. Daha fazla bilgi için Yayınların süresi başlıklı makaleyi inceleyin.
forbidden (403) liveStreamModificationNotAllowed API, akış oluşturulduktan sonra cdn.format, cdn.frameRate, cdn.ingestionType veya cdn.resolution alanlarının değerini değiştirmenize izin vermez.
forbidden (403) liveStreamModificationNotAllowed API, yeniden kullanılabilir bir akışı yeniden kullanılamaz olarak değiştirmenize veya bunun tam tersini yapmanıza izin vermez. Daha fazla bilgi için Yayınları ve akışları anlama başlıklı makaleyi inceleyin.
insufficientPermissions insufficientLivePermissions İstek, belirtilen canlı yayını güncelleme yetkisine sahip değil. 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ı, Özelliklere uygunluk başlıklı makalede daha fazla bilgi bulabilir.
invalidValue (400) invalidDescription snippet.description mülkünün canlı yayın kaynağındaki değeri en fazla 10.000 karakter olabilir.
invalidValue (400) invalidTitle snippet.title mülkünün canlı yayın kaynağındaki değeri 1 ila 128 karakter uzunluğunda olmalıdır.
notFound (404) liveStreamNotFound Belirtilen canlı yayın yok.
required (400) idRequired canlı yayın kaynağı, id özelliği için bir değer belirtmelidir.
required (400) ingestionTypeRequired canlı yayın kaynağı, cdn.ingestionType özelliği için bir değer belirtmelidir.
required (400) titleRequired canlı yayın kaynağı, snippet.title özelliği için bir değer belirtmelidir.

Deneyin!

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