PlaylistItems

playlistItem kaynağı, oynatma listesine dahil edilen başka bir kaynağı (ör. video) tanımlar. Ayrıca, playlistItem kaynağı, dahil edilen kaynakla ilgili ve özellikle bu kaynağın oynatma listesinde nasıl kullanıldığına dair ayrıntılar içerir.

YouTube, bir kanalın yüklenen videolar listesini tanımlamak için de oynatma listesi kullanır. Bu listedeki her playlistItem, yüklenen bir videoyu temsil eder. Belirli bir kanalın channel kaynağını kullanarak bu listenin oynatma listesi kimliğini alabilirsiniz. Ardından, playlistItems.list yöntemini kullanarak listeye ekleyebilirsiniz.

Yöntemler

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

list
API isteği parametreleriyle eşleşen oynatma listesi öğeleri koleksiyonunu döndürür. Belirtilen bir oynatma listesindeki tüm oynatma listesi öğelerini veya benzersiz kimliklerine göre bir veya daha fazla oynatma listesi öğesini alabilirsiniz. Hemen deneyin.
insert
Bir kaynağı oynatma listesine ekler. Hemen deneyin.
güncelleme
Bir oynatma listesi öğesini değiştirir. Örneğin, öğenin çalma listesindeki konumunu güncelleyebilirsiniz. Hemen deneyin.
sil
Oynatma listesi öğesini siler. Hemen deneyin.

Kaynak temsili

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

{
  "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 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
Oynatma listesi öğesinin ait olduğu kanalın kanal başlığı.
snippet.videoOwnerChannelTitle string
Bu videoyu yükleyen kanalın kanal başlığı.
snippet.videoOwnerChannelId string
Bu videoyu yükleyen kanalın kanal kimliği.
snippet.playlistId string
Oynatma listesi öğesinin bulunduğu oynatma listesini YouTube'un benzersiz şekilde tanımlamak için kullandığı kimlik.
snippet.position unsigned integer
Öğenin oynatma listesinde göründüğü sıra. Değerde sıfır tabanlı bir dizin kullanılır. Bu nedenle, ilk öğenin konumu 0, ikinci öğenin konumu 1 olur ve bu şekilde devam eder.
snippet.resourceId object
id nesnesi, oynatma listesine eklenen kaynağı oynatma listesi öğesi olarak benzersiz şekilde tanımlamak için kullanılabilecek bilgileri içerir.
snippet.resourceId.kind string
Başvurulan kaynağın 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 eklenir. Nesne, video hakkında ek bilgiler içerir.
contentDetails.videoId string
YouTube'un bir videoyu benzersiz şekilde tanımlamak için kullandığı kimlik. video kaynağını almak için API isteğinizde id sorgu parametresini bu değere ayarlayın.
contentDetails.startAt string
Not: Bu özelliğin desteği sonlandırıldı. Ayarlanırsa değeri yoksayılır.

Videonun oynatılmaya başlanması gereken zaman (videonun başlangıcından itibaren saniye cinsinden ölçülür). (Oynatma listesi sahibi, video oynatma listesi bağlamında oynatıldığında videonun oynatılmaya başlayacağı ve durdurulacağı zamanları belirleyebilir.) Varsayılan değer 0'dır.
contentDetails.endAt string
Not: Bu özelliğin desteği sonlandırıldı. Ayarlanırsa değeri yoksayılır.

Videonun oynatılmasının durdurulması gereken, videonun başlangıcından itibaren saniye cinsinden ölçülen süre. (Oynatma listesi sahibi, video oynatma listesi bağlamında oynatıldığında videonun oynatılmaya başlayacağı ve durdurulacağı zamanları belirleyebilir.) Varsayılan olarak, video.endTime işaretinin videonun sonu olduğunu varsayın.
contentDetails.note string
Bu öğe için kullanıcı tarafından oluşturulan not. Özellik değeri en fazla 280 karakter uzunluğunda olabilir.
contentDetails.videoPublishedAt datetime
Videonun YouTube'da yayınlandığı tarih ve saat. 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.