Playlists: update

Oynatma listesinde değişiklik yapar. Örneğin, oynatma listesinin başlığını, açıklamasını veya gizlilik durumunu değiştirebilirsiniz.

Kota etkisi: Bu yönteme yapılan bir çağrının 50 birimlik kota maliyeti olur.

Yaygın kullanım örnekleri

İstek

HTTP isteği

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

Yetkilendirme

Bu istek, aşağıdaki kapsamlardan en az biriyle yetkilendirme gerektirir (kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi edinin).

Kapsam
https://www.googleapis.com/auth/youtubepartner
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 amaca hizmet eder. Yazma işleminin ayarlayacağı özelliklerin yanı sıra API yanıtının da içereceği özellikleri tanımlar.

Bu yöntemin, istek gövdesinin belirttiği tüm bölümlerde yer alan, değişebilir özelliklerin mevcut değerlerini geçersiz kılacağını unutmayın. Örneğin, bir oynatma listesinin açıklaması, istek gövdesine eklenmesi gereken snippet bölümünde yer alır. İstekte snippet.description özelliği için bir değer belirtilmezse oynatma listesinin mevcut açıklaması silinir.

Aşağıdaki listede, parametre değerine ekleyebileceğiniz part adları bulunmaktadır:
  • contentDetails
  • id
  • localizations
  • player
  • snippet
  • status
İ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çindir.

onBehalfOfContentOwner parametresi, isteğin yetkilendirme kimlik bilgilerinin, parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube İçerik Yönetim Sistemi kullanıcısını tanımladığını gösterir. Bu parametre, birçok farklı YouTube kanalına sahip olan ve bunları 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 kimlik doğrulaması yaptığı CMS hesabı, belirtilen YouTube içerik sahibine bağlı olmalıdır.

İstek içeriği

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

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

    • id
    • snippet.title

  • Şu özellikler için değerler ayarlayabilirsiniz:

    • snippet.title
    • snippet.description
    • status.privacyStatus
    • status.podcastStatus
    • snippet.defaultLanguage
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description

    Bir güncelleme isteği gönderiyorsanız ve isteğiniz, halihazırda bir değere sahip bir mülk için değer belirtmiyorsa mülkün mevcut değeri silinir.

Yanıt

Başarılı olursa bu yöntem, yanıt gövdesinde bir oynatma listesi 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 lütfen hata mesajı ile ilgili dokümanları inceleyin.

Hata türü Hata ayrıntısı Açıklama
badRequest (400) defaultLanguageNotSetError defaultLanguage, localizations öğesini güncelleyecek şekilde ayarlanmalıdır.
badRequest (400) localizationValidationError Yerelleştirmeler nesnesindeki değerlerden biri doğrulanamadı. Geçerli değerleri almak için playlists.list yöntemini kullanın. Bu değerleri, oynatma listesi kaynak dokümanlarındaki kurallara uygun şekilde güncellediğinizden emin olun.
forbidden (403) playlistForbidden Bu işlem yasaklanmıştır veya istek düzgün şekilde yetkilendirilmemiştir.
invalidValue (400) invalidPlaylistSnippet İstek, geçersiz bir oynatma listesi snippet'i sağlıyor.
notFound (404) playlistNotFound İsteğin id parametresiyle tanımlanan oynatma listesi bulunamıyor.
required (400) playlistTitleRequired İstekte bir oynatma listesi başlığı belirtilmelidir.
invalidValue (400) playlistOperationUnsupported API, belirtilen oynatma listesini güncelleme özelliğini desteklemiyor. Örneğin, yüklenen videolar oynatma listenizin özelliklerini güncelleyemezsiniz.

Deneyin!

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