Playlists

playlist kaynağı, bir YouTube oynatma listesini temsil eder. Oynatma listesi, sırayla görüntülenebilecek ve diğer kullanıcılarla paylaşılabilecek bir video koleksiyonudur. Oynatma listeleri varsayılan olarak diğer kullanıcılar tarafından görülebilir ancak herkese açık veya gizli olabilir.

YouTube, bir kanal için aşağıdakiler gibi özel video koleksiyonlarını tanımlamak amacıyla oynatma listelerini de kullanır:

• yüklenen videolar
• olumlu oy verilen (beğenilen) videolar

Daha açık şekilde belirtmek gerekirse bu listeler bir kanalla ilişkilendirilir. Kanal, kişi, grup veya şirket videoları, oynatma listeleri ve diğer YouTube bilgilerinden oluşur. Bu kanalların her birine ait oynatma listesi kimliklerini belirli bir kanal için channel resource üzerinden alabilirsiniz.

Ardından, bu listelerden herhangi birini almak için playlistItems.list yöntemini kullanabilirsiniz. playlistItems.insert ve playlistItems.delete yöntemlerini çağırarak bu listelere öğe ekleyebilir veya mevcut öğeleri kaldırabilirsiniz.

Yöntemler

API, playlists kaynakları için aşağıdaki yöntemleri destekler:

list

API isteği parametreleriyle eşleşen oynatma listelerinden oluşan bir koleksiyon döndürür. Örneğin, kimliği doğrulanmış kullanıcının sahip olduğu tüm oynatma listelerini veya benzersiz kimliklerine göre bir veya daha fazla oynatma listesi alabilirsiniz. Hemen deneyin.

ekle

Oynatma listesi oluşturur. Hemen deneyin.

güncelle

Bir oynatma listesini değiştirir. Örneğin, bir oynatma listesinin başlığını, açıklamasını veya gizlilik durumunu değiştirebilirsiniz. Hemen deneyin.

sil

Bir oynatma listesini siler. Hemen deneyin.

Kaynak temsili

Aşağıdaki JSON yapısı, bir playlists kaynağının biçimini göstermektedir:

{
  "kind": "youtube#playlist",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    }
  },
  "status": {
    "privacyStatus": string
  },
  "contentDetails": {
    "itemCount": unsigned integer
  },
  "player": {
    "embedHtml": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

Özellikler

Aşağıdaki tabloda, bu kaynakta görünen özellikler tanımlanmaktadır:

Özellikler
kind	string API kaynağının türünü tanımlar. Değer youtube#playlist olacak.
etag	etag Bu kaynağın Etag'i.
id	string YouTube'un oynatma listesini benzersiz şekilde tanımlamak için kullandığı kimlik.
snippet	object snippet nesnesi, oynatma listesi hakkında başlık ve açıklama gibi temel ayrıntıları içerir.
snippet.publishedAt	datetime Oynatma listesinin oluşturulduğu tarih ve saat. Değer ISO 8601 biçiminde belirtilir.
snippet.channelId	string YouTube'un oynatma listesini yayınlayan kanalı benzersiz şekilde tanımlamak için kullandığı kimliktir.
snippet.title	string Oynatma listesinin başlığı.
snippet.description	string Oynatma listesinin açıklaması.
snippet.thumbnails	object Oynatma listesiyle ilişkili küçük resim haritalarının haritası. Haritadaki her bir nesne için anahtar, küçük resmin adı, değer de küçük resim hakkında diğer bilgileri içeren bir nesnedir.
snippet.thumbnails.(key)	object Geçerli anahtar değerleri şunlardır: default – Varsayılan küçük resim. Bir videonun (veya oynatma listesi öğesi ya da arama sonucu gibi) bir videoya atıfta bulunan kaynağın varsayılan küçük resmi 120 piksel genişliğinde ve 90 piksel yüksekliğindedir. Bir kanalın varsayılan küçük resmi 88 piksel genişliğinde ve 88 piksel yüksekliğindedir. medium – Küçük resmin daha yüksek çözünürlüklü bir sürümü. Bir video (veya bir videoya atıfta bulunan kaynaklar) için bu resim 320 piksel genişliğinde ve 180 piksel yüksekliğinde. Bir kanal için bu resim 240 piksel genişliğinde ve 240 piksel yüksekliğindedir. high – Küçük resmin yüksek çözünürlüklü sürümü. Bir video (veya bir videoya referans veren kaynak) için bu resim 480 piksel genişliğinde ve 360 piksel yüksekliğindedir. Kanal için bu resim 800 piksel genişliğinde ve 800 piksel yüksekliğindedir. standard – Küçük resmin high çözünürlük resminden bile daha yüksek çözünürlüklü bir sürümü. Bu resim, bazı videolarda ve videolara atıfta bulunan diğer kaynaklarda (ör. oynatma listesi öğeleri veya arama sonuçları) kullanılabilir. Bu resim 640 piksel genişliğinde ve 480 piksel yüksekliğindedir. maxres – Küçük resmin en yüksek çözünürlüklü sürümü. Bu resim boyutu, bazı videoların yanı sıra oynatma listeleri veya arama sonuçları gibi videolara atıfta bulunan diğer kaynaklar için kullanılabilir. Bu resim 1280 piksel genişliğinde ve 720 piksel yüksekliğindedir.
snippet.thumbnails.(key).url	string Resmin URL'si.
snippet.thumbnails.(key).width	unsigned integer Resmin genişliği.
snippet.thumbnails.(key).height	unsigned integer Resmin yüksekliği.
snippet.channelTitle	string Videonun ait olduğu kanalın başlığı.
snippet.tags[]	list Bu mülk kullanımdan kaldırıldı. Oynatma listesiyle ilişkili anahtar kelime etiketleri.
snippet.defaultLanguage	string playlist kaynağının snippet.title ve snippet.description özelliklerindeki metnin dili.
snippet.localized	object snippet.localized nesnesi, oynatma listesi için yerelleştirilmiş bir başlık ve açıklama veya oynatma listesinin meta verileri için varsayılan dilde başlık içerir. Yerelleştirilmiş metin, playlists.list parametresi yerelleştirilmiş metnin döndürülmesi gereken ve yerelleştirilmiş metnin bu dilde kullanılabilir olduğu dili belirtmek için kullandıysa kaynak snippet'inde döndürülür. Bir hl parametre değeri belirtilmemişse veya bir değer belirtilmişse ancak belirtilen dil için yerelleştirilmiş meta veriler yoksa varsayılan dilin meta verileri döndürülür. Bu özellik salt okunur bir değer içeriyor. Yerelleştirilmiş başlıklar eklemek, güncellemek veya silmek için localizations nesnesini kullanın.
snippet.localized.title	string Yerelleştirilmiş oynatma listesi başlığı.
snippet.localized.description	string Yerelleştirilmiş oynatma listesi açıklaması.
status	object status nesnesi, oynatma listesinin durum bilgilerini içerir.
status.privacyStatus	string Oynatma listesinin gizlilik durumu. Bu mülk için geçerli değerler şunlardır: private public unlisted
contentDetails	object contentDetails nesnesi, oynatma listesindeki videoların sayısı da dahil olmak üzere oynatma listesi içeriğiyle ilgili bilgiler içerir.
contentDetails.itemCount	unsigned integer Oynatma listesindeki video sayısı.
player	object player nesnesi, oynatma listesini yerleşik bir oynatıcıda oynatmak için kullanacağınız bilgileri içerir.
player.embedHtml	string Oynatma listesini oynatacak bir oynatıcının yerleştirildiği <iframe> etiketi.
localizations	object localizations nesnesi, oynatma listesinin meta verilerinin çevirilerini kapsar.
localizations.(key)	object Anahtar/değer çiftiyle ilişkili yerelleştirilmiş metnin dilidir. Değer, BCP-47 dil kodu içeren bir dizedir.
localizations.(key).title	string Yerelleştirilmiş oynatma listesi başlığı.
localizations.(key).description	string Yerelleştirilmiş oynatma listesi açıklaması.