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

PlaylistItems

playlistItem kaynağı, oynatma listesine eklenen video gibi başka bir kaynağı tanımlar. Ayrıca playlistItem kaynağı, eklenen kaynakla ilgili ayrıntıları içerir ve özellikle söz konusu kaynağın bu oynatma listesinde nasıl kullanıldığıyla ilgilidir.

YouTube, bir kanalın yüklenen video listesini tanımlamak için de oynatma listesi kullanır. Bu listede her playlistItem, yüklenen bir videoyu temsil eder. Bu listenin oynatma listesi kimliğini belirli bir kanal için channel resource üzerinden alabilirsiniz. Ardından, listede playlistItems.list yöntemini kullanabilirsiniz.

Yöntemler

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

list: API isteği parametreleriyle eşleşen oynatma listesi öğelerinden oluşan bir koleksiyon döndürür. Belirtilen oynatma listesindeki tüm oynatma listesi öğelerini 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ı, bir playlistItems kaynağının biçimini göstermektedir:

{
  "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` olacak.
`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 öğesinin başlığı ve oynatma listesindeki konumu gibi temel ayrıntıları 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 oynatma listesine öğe ekleyen kullanıcıyı benzersiz şekilde tanımlamak için kullandığı kimliktir.
`snippet.title`	`string` Öğenin başlığı.
`snippet.description`	`string` Öğenin açıklaması.
`snippet.thumbnails`	`object` Oynatma listesi öğesiyle ilişkili küçük resim 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: `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 yüksekliğindedir. `medium` – Küçük resmin daha yüksek çözünürlüklü bir sürümü. Bir video (veya bir videoya atıfta bulunan kaynaklar) için bu resim 320 piksel genişliğinde ve 180 piksel yüksekliğinde. Bir 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 bir videoya referans veren 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 yüksekliğindedir. `standard` – Küçük resmin `high` çözünürlük resminden bile 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ın yanı sıra oynatma listeleri veya arama sonuçları gibi videolara atıfta bulunan diğer kaynaklar için kullanılabilir. Bu resim 1280 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 adı.
`snippet.videoOwnerChannelId`	`string` Bu videoyu yükleyen kanalın kanal kimliği.
`snippet.playlistId`	`string` YouTube'un oynatma listesi öğesinin içinde olduğu oynatma listesini benzersiz şekilde tanımlamak için kullandığı kimlik.
`snippet.position`	`unsigned integer` Öğenin oynatma listesinde gösterildiği 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 bilgiler 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 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 eklenir. 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 özellik kullanımdan kaldırılmıştır ve ayarlanmışsa değeri göz ardı edilir. Videonun başlangıcından itibaren saniye cinsinden ölçülen, videonun oynatılmaya başlaması gereken zaman. (Oynatma listesi sahibi, oynatma listesi bağlamında videonun oynatılacağı ve biteceği zamanları belirtebilir.) Varsayılan değer: `0`
`contentDetails.endAt`	`string` Not: Bu özellik kullanımdan kaldırılmıştır ve ayarlanmışsa değeri göz ardı edilir. Videonun başlangıcından itibaren saniye cinsinden ölçülen, videonun oynatılmasının duracağı zaman. (Oynatma listesi sahibi, oynatma listesi bağlamında videonun oynatılacağı ve biteceği zamanları belirtebilir.) Varsayılan olarak, `video.endTime` ifadesinin videonun sonu olduğunu varsayın.
`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 durumu hakkında bilgi içerir.
`status.privacyStatus`	`string` Oynatma listesi öğesinin gizlilik durumu. Oynatma listesi öğesinin temsil ettiği videoyu yükleyen kanal, `videos.insert` veya `videos.update` yöntemini kullanarak bu değeri ayarlayabilir.