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
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:
|
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.
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 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ı. |