playlistItem
kaynağı, oynatma listesinde yer alan başka bir kaynağı (ör. video) tanımlar. Ek olarak, playlistItem
kaynağında, dahil edilen kaynakla ilgili olan ve söz konusu kaynağın ilgili oynatma listesinde nasıl kullanıldığıyla ilgili olan ayrıntılar da yer alır.
YouTube, kanalın yüklenen videolar listesini tanımlamak için bir oynatma listesi de kullanır. Bu listedeki her playlistItem
, yüklenen bir videoyu temsil eder. İlgili kanalın oynatma listesi kimliğini channel resource
öğesinden alabilirsiniz. Daha sonra liste için playlistItems.list
yöntemini kullanabilirsiniz.
Yöntemler
API, playlistItems
kaynakları için aşağıdaki yöntemleri destekler:
- list
- API istek parametreleriyle eşleşen oynatma listesi öğelerinin bir koleksiyonunu döndürür. Belirli bir oynatma listesindeki oynatma listesi öğelerinin tümünü alabilir veya benzersiz kimliklerine göre bir ya da daha fazla oynatma listesi öğesi alabilirsiniz. Hemen deneyin.
- ekle
- Oynatma listesine kaynak ekler. Hemen deneyin.
- güncelle
- Oynatma listesi öğesini değiştirir. Örneğin, öğenin oynatma listesindeki konumunu güncelleyebilirsiniz. Hemen deneyin.
- sil
- Oynatma listesi öğesini siler. Hemen deneyin.
Kaynak temsili
Aşağıdaki JSON yapısı, playlistItems
kaynağının biçimini gösterir:
{ "kind": "youtube#playlistItem", "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, "videoOwnerChannelTitle": string, "videoOwnerChannelId": string, "playlistId": string, "position": unsigned integer, "resourceId": { "kind": string, "videoId": string, } }, "contentDetails": { "videoId": string, "startAt": string, "endAt": string, "note": string, "videoPublishedAt": datetime }, "status": { "privacyStatus": 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#playlistItem olur. |
etag |
etag Bu kaynağın Etag'i. |
id |
string YouTube'un oynatma listesi öğesini benzersiz şekilde tanımlamak için kullandığı kimlik. |
snippet |
object snippet nesnesi, oynatma listesi öğesiyle ilgili temel ayrıntıları (ör. başlığı ve oynatma listesindeki konumu) içerir. |
snippet.publishedAt |
datetime Öğenin oynatma listesine eklendiği tarih ve saat. Değer, ISO 8601 biçiminde belirtilir. |
snippet.channelId |
string YouTube'un öğeyi oynatma listesine ekleyen kullanıcıyı benzersiz şekilde tanımlamak için kullandığı kimlik. |
snippet.title |
string Öğenin başlığı. |
snippet.description |
string Öğenin açıklaması. |
snippet.thumbnails |
object Oynatma listesi öğesiyle 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 Oynatma listesi öğesinin ait olduğu kanalın başlığıdır. |
snippet.videoOwnerChannelTitle |
string Bu videoyu yükleyen kanalın başlığı. |
snippet.videoOwnerChannelId |
string Bu videoyu yükleyen kanalın kimliği. |
snippet.playlistId |
string YouTube'un, oynatma listesi öğesinin bulunduğu oynatma listesini benzersiz şekilde tanımlamak için kullandığı kimlik. |
snippet.position |
unsigned integer Öğenin oynatma listesinde göründüğü sıra. Değer, sıfır tabanlı bir dizin kullandığından ilk öğenin konumu 0 , ikinci öğenin konumu 1 olur ve bu böyle devam eder. |
snippet.resourceId |
object id nesnesi, oynatma listesine dahil edilen kaynağı, oynatma listesi öğesi olarak benzersiz şekilde tanımlamak için kullanılabilecek bilgileri içerir. |
snippet.resourceId.kind |
string Yönlendirilen kaynağın türü veya türü. |
snippet.resourceId.videoId |
string snippet.resourceId.kind özelliğinin değeri youtube#video ise bu özellik mevcut olur ve değeri, YouTube'un oynatma listesindeki videoyu benzersiz şekilde tanımlamak için kullandığı kimliği içerir. |
contentDetails |
object Dahil edilen öğe bir YouTube videosuysa contentDetails nesnesi kaynağa dahil edilir. Nesne, videoyla ilgili ek bilgiler içerir. |
contentDetails.videoId |
string YouTube'un videoyu benzersiz şekilde tanımlamak için kullandığı kimlik. video kaynağını almak için id sorgu parametresini API isteğinizde bu değere ayarlayın. |
contentDetails.startAt |
string Not: Bu özellik kullanımdan kaldırılmıştır ve ayarlanırsa değeri yoksayılır. Videonun başlangıcından itibaren saniye cinsinden ölçülen, videonun oynatılmaya başlaması gereken süre. (Oynatma listesinin sahibi, videonun oynatma listesi bağlamında oynatıldığında oynatmanın başlayacağı ve duracağı zamanları belirtebilir.) Varsayılan değer 0 değeridir. |
contentDetails.endAt |
string Not: Bu özellik kullanımdan kaldırılmıştır ve ayarlanırsa değeri yoksayılır. Videonun başlangıcından itibaren saniye cinsinden ölçülen, videonun oynatılmasının durması gereken süre. (Oynatma listesinin sahibi, videonun oynatma listesi bağlamında oynatıldığında oynatmanın başlayacağı ve duracağı zamanları belirtebilir.) Varsayılan olarak video.endTime öğesinin, videonun sonu olduğunu varsayın. |
contentDetails.note |
string Bu öğe için kullanıcı tarafından oluşturulan bir not. Mülk değeri en fazla 280 karakter uzunluğunda olabilir. |
contentDetails.videoPublishedAt |
datetime Videonun YouTube'da yayınlandığı tarih ve saattir. Değer, ISO 8601 biçiminde belirtilir. |
status |
object status nesnesi, oynatma listesi öğesinin gizlilik durumuyla ilgili bilgileri içerir. |
status.privacyStatus |
string Oynatma listesi öğesinin gizlilik durumu. Oynatma listesi öğesinin temsil ettiği videoyu yükleyen kanal, bu değeri videos.insert veya videos.update yöntemini kullanarak ayarlayabilir. |