playlist
kaynağı, bir YouTube oynatma listesini temsil eder. Oynatma listesi, sıralı olarak görüntülenebilen ve diğer kullanıcılarla paylaşılabilen bir video koleksiyonudur. Varsayılan olarak, oynatma listeleri diğer kullanıcılar tarafından görülebilir ancak oynatma listeleri herkese açık veya gizli olabilir.
YouTube, oynatma listelerini bir kanal için aşağıdaki gibi özel video koleksiyonlarını tanımlamak amacıyla da kullanır:
- yüklenen videolar
- olumlu oy alan (beğenilen) videolar
channel resource
öğesinden alabilirsiniz.Daha sonra, bu listelerden 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 listelerdeki öğeleri kaldırabilirsiniz.
Yöntemler
API, playlists
kaynakları için aşağıdaki yöntemleri destekler:
- list
- API istek parametreleriyle eşleşen oynatma listeleri koleksiyonunu döndürür. Örneğin, kimliği doğrulanmış kullanıcının sahip olduğu tüm oynatma listelerini ya da benzersiz kimliklerine göre bir veya daha fazla oynatma listesini alabilirsiniz. Hemen deneyin.
- ekle
- Oynatma listesi oluşturur. Hemen deneyin.
- güncelle
- 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ı, playlists
kaynağının biçimini gösterir:
{ "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 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 bir nesne için anahtar, küçük resmin adı ve değer, küçük resimle ilgili diğer bilgileri içeren bir nesnedir. |
snippet.thumbnails.(key) |
object Geçerli anahtar değerleri şunlardır:
|
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ığıdır. |
snippet.tags[] |
list Bu özellik kullanımdan kaldırılmıştır. Oynatma listesiyle ilişkilendirilen 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.
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:
|
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 videoların sayısı. |
player |
object player nesnesi, oynatma listesini yerleştirilmiş oynatıcıda oynatmak için kullanabileceğiniz bilgileri içerir. |
player.embedHtml |
string Oynatma listesini oynatacak oynatıcıyı yerleştiren <iframe> etiketi. |
localizations |
object localizations nesnesi, oynatma listesinin meta verilerinin çevirilerini içerir. |
localizations.(key) |
object Anahtar değerle ilişkili yerelleştirilmiş metnin dili. Bu 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ı. |