Playlists

playlist kaynağı, bir YouTube oynatma listesini temsil eder. Oynatma listesi, sırayla izlenebilen ve diğer kullanıcılarla paylaşılabilen videolardan oluşan bir koleksiyondur. Oynatma listeleri varsayılan olarak diğer kullanıcılara herkese açık şekilde gösterilir ancak oynatma listeleri herkese açık veya gizli olabilir.

YouTube, kanallardaki özel video koleksiyonlarını belirlemek için de oynatma listelerini kullanır. Örneğin:

  • yüklenen videolar
  • olumlu olarak derecelendirilmiş (beğenilmiş) videolar
Daha net bir ifadeyle, bu listeler bir kanalla ilişkilendirilir. Kanal, bir kişinin, grubun veya şirketin videolarının, oynatma listelerinin ve diğer YouTube bilgilerinin bir araya getirildiği bir koleksiyondur. Bu listelerin her birinin oynatma listesi kimliklerini, belirli bir kanalın channel resource bölümünden alabilirsiniz.

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

Yöntemler

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

list
API isteği parametreleriyle eşleşen oynatma listelerinin koleksiyonunu 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 ya da daha fazla oynatma listesini alabilirsiniz. Hemen deneyin.
insert
Oynatma listesi oluşturur. Hemen deneyin.
güncelleme
Oynatma listesini değiştirir. Örneğin, oynatma listesinin başlığını, açıklamasını veya gizlilik durumunu değiştirebilirsiniz. Hemen deneyin.
sil
Oynatma listesini siler. Hemen deneyin.

Kaynak temsili

Aşağıdaki JSON yapısında, playlists kaynağının biçimi gösterilmektedir:

{
  "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,
    "podcastStatus": enum
  },
  "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 olur.
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 listesiyle ilgili temel ayrıntıları (ör. başlığı ve açıklaması) 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ığı kimlik.
snippet.title string
Oynatma listesinin başlığı.
snippet.description string
Oynatma listesinin açıklaması.
snippet.thumbnails object
Oynatma listesiyle ilişkili küçük resimlerin haritası. Haritadaki her nesne için anahtar, küçük resmin adı, değer ise küçük resimle ilgili diğer bilgileri içeren bir nesnedir.
snippet.thumbnails.(key) object
Geçerli anahtar değerleri:
  • default: Varsayılan küçük resim. Bir video veya videoya referans veren bir kaynak (ör. oynatma listesi öğesi ya da arama sonucu) için varsayılan küçük resim 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ü. Video (veya videoya atıfta bulunan bir kaynak) için bu resim 320 piksel genişliğinde ve 180 piksel yüksekliğindedir. Kanallar 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 videoya atıfta bulunan bir kaynak) için bu resim 480 piksel genişliğinde ve 360 piksel yüksekliğindedir. Kanallar için bu resim 800 piksel genişliğinde ve 800 piksel yüksekliğindedir.
  • standard: Küçük resmin, high çözünürlüklü resimden daha yüksek çözünürlüklü bir sürümü. Bu resim, bazı videolar ve oynatma listesi öğeleri ya da arama sonuçları gibi videolara atıfta bulunan diğer kaynaklar için 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 ve videolara referans veren diğer kaynaklar (ör. oynatma listesi öğeleri veya arama sonuçları) için kullanılabilir. Bu resim 1.280 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 özelliğin desteği sonlandı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 ya da oynatma listesinin meta verileri için varsayılan dildeki başlığı içerir.
  • playlists.list isteğinde, yerelleştirilmiş metnin döndürülmesi gereken bir dil belirtmek için hl parametresi kullanıldıysa ve bu dilde yerelleştirilmiş metin varsa yerelleştirilmiş metin kaynak snippet'inde döndürülür.
  • Bir hl parametre değeri belirtilmemişse veya bir değer belirtilmiş ancak belirtilen dil için yerelleştirilmiş meta veriler mevcut değilse varsayılan dilin meta verileri döndürülür.
Ö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 özelliğin geçerli değerleri şunlardır:
  • private
  • public
  • unlisted
status.podcastStatus string
Oynatma listesinin podcast durumu. Değer enabled ise oynatma listesi podcast programı olarak işaretlenir. Bir oynatma listesinin podcast durumunu enabled olarak ayarlamak için oynatma listesinde oynatma listesi resmi bulunmalıdır.

Bu özelliğin geçerli değerleri şunlardır:
  • enabled
  • disabled
  • unspecified
contentDetails object
contentDetails nesnesi, oynatma listesindeki videoların sayısı da dahil olmak üzere oynatma listesi içeriğiyle ilgili bilgileri içerir.
contentDetails.itemCount unsigned integer
Oynatma listesindeki videoların sayısı.
player object
player nesnesi, oynatma listesini yerleştirilmiş bir oynatıcıda oynatmak için kullanacağınız bilgileri içerir.
player.embedHtml string
Oynatma listesini oynatacak bir oynatıcıyı yerleştiren <iframe> etiketi.
localizations object
localizations nesnesi, oynatma listesinin meta verilerinin çevirilerini kapsar.
localizations.(key) object
Anahtar değeriyle ilişkili yerelleştirilmiş metnin dili. 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ı.