Bu sayfa, Cloud Translation API ile çevrilmiştir.

PlaylistItems

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

YouTube, bir kanalın yüklenen videolarının 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ğından bu listenin oynatma listesi kimliğini alabilirsiniz. Ardından, listeyi playlistItems.list yöntemiyle

Yöntemler

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

list: API istek parametreleriyle eşleşen bir oynatma listesi öğesi koleksiyonu döndürür. Belirli bir oynatma listesindeki tüm oynatma listesi öğelerini veya benzersiz kimliklerine göre bir veya daha fazla oynatma listesi öğesini alabilirsiniz. Hemen deneyin.
insert: 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ı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 değeri.
`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 şarkı 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 resim adıdır ve değer, 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 videonun veya videoya atıfta bulunan bir kaynağın (ör. oynatma listesi öğesi veya arama sonucu) varsayılan küçük resmi 120 piksel genişliğinde ve 90 piksel yüksekliğindedir. Kanalları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ü. Videolar (veya videoya atıfta bulunan kaynaklar) 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ü. Videolar (veya videoya atıfta bulunan kaynaklar) 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ı videolarda ve videolara atıfta bulunan diğer kaynaklarda (ör. oynatma listesi öğeleri veya arama sonuçları) 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 atıfta bulunan 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 başlığı.
`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 kullanır. Bu nedenle, ilk öğenin konumu `0`, ikinci öğenin konumu `1` şeklinde devam eder.
`snippet.resourceId`	`object` `id` nesnesi, oynatma listesine oynatma listesi öğesi olarak eklenen kaynağı benzersiz şekilde tanımlamak için kullanılabilecek bilgileri içerir.
`snippet.resourceId.kind`	`string` Atıf yapılan kaynağın türü.
`snippet.resourceId.videoId`	`string` `snippet.resourceId.kind` mülkünün değeri `youtube#video` ise bu mülk 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 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ılmıştır ve ayarlanmışsa değeri yoksayılır. Videonun oynatılmaya başlaması gereken zaman (videonun başlangıcından itibaren saniye cinsinden ölçülür). (Şarkı listesi sahibi, videonun oynatma listesi bağlamında oynatıldığında videonun oynatılmaya başlayacağı ve durdurulacağı zamanları belirtebilir.) Varsayılan değer: `0`.
`contentDetails.endAt`	`string` Not: Bu özelliğin desteği sonlandırılmıştır ve ayarlanmışsa değeri yoksayılır. Videonun oynatılmasının durdurulması gereken zaman (videonun başlangıcından itibaren saniye cinsinden ölçülür). (Şarkı listesi sahibi, videonun oynatma listesi bağlamında oynatıldığında videonun oynatılmaya başlayacağı ve durdurulacağı zamanları belirtebilir.) Varsayılan olarak, `video.endTime` değerinin videonun sonu olduğu kabul edilir.
`contentDetails.note`	`string` Bu öğe için kullanıcı tarafından oluşturulan not. Mülk 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.