PlaylistItems: update

Oynatma listesi öğesini değiştirir. Örneğin, öğenin oynatma listesindeki konumunu güncelleyebilirsiniz.

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

Yaygın kullanım alanları

İstek

HTTP isteği

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

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 içereceği özellikleri tanımlar.

Bu yöntemin, parametre değerinin belirttiği tüm bölümlerde bulunan değiştirilebilir özelliklerin mevcut değerlerini geçersiz kılacağını unutmayın. Örneğin, bir oynatma listesi öğesi, kullanıcılar videoyu oynatma listesinde izlediğinde videonun oynatılması gereken zaman bölümünü tanımlayan bir başlangıç zamanı ve bitiş zamanı belirtebilir. İsteğiniz bu değerleri ayarlayan bir oynatma listesi öğesini güncelliyorsa ve isteğin part parametre değeri contentDetails bölümünü içeriyorsa oynatma listesi öğesinin başlangıç ve bitiş zamanları, istek gövdesinde belirtilen değere göre güncellenir. İstek gövdesinde değer belirtilmezse mevcut başlangıç ve bitiş zamanları kaldırılır ve varsayılan ayarlarla değiştirilir.

Aşağıdaki listede, parametre değerine ekleyebileceğiniz part adları yer almaktadır:
  • contentDetails
  • id
  • snippet
  • status
İsteğe bağlı parametreler
onBehalfOfContentOwner string
Not: onBehalfOfContentOwner parametresi yalnızca YouTube içerik iş ortakları için tasarlanmıştır ve yalnızca uygun şekilde yetkilendirilmiş bir istekte kullanılabilir.

Bu parametre, birçok farklı YouTube kanalının sahibi ve yöneticisi olan YouTube içerik iş ortakları için tasarlanmıştır. Bu parametre, içerik sahibiyle ilişkili kullanıcıların bir kez kimlik doğrulamasına ve ardından her kanal için kimlik doğrulama bilgileri sağlamak zorunda kalmadan içerik sahibinin tüm video ve kanal verilerine erişip bunları yönetmesine olanak tanır.

Parametre mevcut olduğunda değeri bir içerik sahibini tanımlar ve isteğin yetkilendirme bilgileri, söz konusu içerik sahibi adına hareket etmeye yetkili bir YouTube kullanıcısını tanımlar. Kullanıcının kimliğini doğruladığı hesap, YouTube Creator Studio ayarlarında belirtilen içerik sahibine bağlı olmalıdır.

İstek metni

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

  • Bu özellikler için bir değer belirtmeniz gerekir:

    • id
    • snippet.playlistId
    • snippet.resourceId

  • Bu özellikler için değerler ayarlayabilirsiniz:

    • snippet.position
    • contentDetails.note
    • contentDetails.startAt
    • contentDetails.endAt

    Bir güncelleme isteği gönderiyorsanız ve isteğinizde, zaten değeri olan bir özellik için değer belirtilmiyorsa özelliğin mevcut değeri silinir.

Yanıt

Başarılı olursa bu yöntem, yanıt gövdesinde bir playlistItem 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ı belirtilmektedir. Daha fazla bilgi için lütfen hata mesajı belgelerine bakın.

Hata türü Hata ayrıntısı Açıklama
forbidden (403) playlistItemsNotAccessible İstek, belirtilen oynatma listesi öğesini güncellemek için uygun şekilde yetkilendirilmedi.
invalidValue (400) invalidPlaylistItemPosition İstek, oynatma listesi öğesinin konumunu geçersiz veya desteklenmeyen bir değere ayarlamaya çalışıyor. Kaynağın snippet bölümündeki position özelliğinin değerini kontrol edin.
invalidValue (400) invalidResourceType Kaynak kimliği için belirtilen type bu işlemde desteklenmiyor. Kaynak kimliği, oynatma listesine eklenen öğeyi tanımlar (ör. youtube#video).
invalidValue (400) invalidSnippet İstekte geçerli bir snippet mülkü belirtilmiyor.
invalidValue (400) manualSortRequired İstek, oynatma listesi öğesinin konumunu ayarlamaya çalışıyor ancak oynatma listesi manuel sıralama kullanmıyor. (Örneğin, oynatma listesi öğeleri tarihe veya popülerliğe göre sıralanabilir.) İsteğin eklediği kaynaktan snippet.position öğesini kaldırarak hatayı giderebilirsiniz. Oynatma listesi öğesinin listede belirli bir konuma sahip olmasını istiyorsanız öncelikle oynatma listesinin ayarlarında oynatma listesinin Sıralama seçeneğini Manuel olarak güncellemeniz gerekir. Bu ayar, YouTube Video Yöneticisi'nden düzenlenebilir.
notFound (404) playlistItemNotFound İsteğin id özelliğiyle tanımlanan oynatma listesi öğesi bulunamadı.
notFound (404) playlistNotFound İsteğin playlistId parametresiyle tanımlanan oynatma listesi bulunamıyor.
required (400) channelIdRequired İstek, gerekli channelId özelliği için bir değer belirtmiyor.
required (400) playlistIdRequired İstekte, gerekli playlistId özelliği için bir değer belirtilmemiş.
required (400) playlistItemIdRequired İstekle belirtilen oynatma listesi öğesi kaynağı, güncellenen oynatma listesi öğesini tanımlamak için id özelliğini kullanmalıdır.
invalidValue (400) playlistOperationUnsupported API, belirtilen oynatma listesindeki videoları güncelleme özelliğini desteklemiyor. Örneğin, yüklenen videolar oynatma listenizdeki bir videoyu güncelleyemezsiniz.

Deneyin.

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