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

PlaylistItems

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: `default` – Varsayılan küçük resim. Bir videonun (veya oynatma listesi öğesi ya da arama sonucu gibi bir videoya atıfta bulunan kaynağın) varsayılan küçük resmi 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 uzunluğundadır. `medium` – Küçük resmin daha yüksek çözünürlüklü sürümü. Bir video (veya videoya atıfta bulunan bir kaynak) için bu resim 320 piksel genişliğinde ve 180 piksel yüksekliğindedir. Kanal 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. Kanal için bu resim 800 piksel genişliğinde ve 800 piksel uzunluğundadır. `standard` – Küçük resmin `high` çözünürlüklü resimden daha yüksek çözünürlüklü 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ğinde. `maxres` – Küçük resim görüntüsünün en yüksek çözünürlüklü sürümü. Bu resim boyutu, bazı videolarda ve videolara atıfta bulunan diğer kaynaklarda (ör. oynatma listesi öğeleri ya da arama sonuçları) kullanılabilir. Bu resim 1.280 piksel genişliğinde ve 720 piksel yüksekliğinde.
`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.