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

Playlists

playlist kaynağı, bir YouTube oynatma listesini temsil eder. Oynatma listesi, sıralı olarak görüntülenebilen ve diğer kullanıcılarla paylaşılabilen bir video koleksiyonudur. Varsayılan olarak, oynatma listeleri diğer kullanıcılar tarafından görülebilir ancak oynatma listeleri herkese açık veya gizli olabilir.

YouTube, oynatma listelerini bir kanal için aşağıdaki gibi özel video koleksiyonlarını tanımlamak amacıyla da kullanır:

yüklenen videolar
olumlu oy alan (beğenilen) videolar

Daha spesifik olmak gerekirse bu listeler bir kanalla ilişkilendirilir. Kanal; bir kişi, grup veya şirketin videolarından, oynatma listelerinden ve diğer YouTube bilgilerinden oluşur. Bu listelerin her birinin oynatma listesi kimliklerini belirli bir kanal için channel resource öğesinden alabilirsiniz.

Daha sonra, bu listelerden herhangi birini almak için playlistItems.list yöntemini kullanabilirsiniz. Ayrıca, playlistItems.insert ve playlistItems.delete yöntemlerini çağırarak bu listelere öğe ekleyebilir veya listelerdeki öğeleri kaldırabilirsiniz.

Yöntemler

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

list: API istek parametreleriyle eşleşen oynatma listeleri koleksiyonunu döndürür. Örneğin, kimliği doğrulanmış kullanıcının sahip olduğu tüm oynatma listelerini ya da benzersiz kimliklerine göre bir veya daha fazla oynatma listesini alabilirsiniz. Hemen deneyin.
ekle: Oynatma listesi oluşturur. Hemen deneyin.
güncelle: Oynatma listesini değiştirir. Örneğin, bir oynatma listesinin başlığını, açıklamasını veya gizlilik durumunu değiştirebilirsiniz. Hemen deneyin.
sil: Bir oynatma listesini siler. Hemen deneyin.

Kaynak temsili

Aşağıdaki JSON yapısı, playlists kaynağının biçimini gösterir:

{
  "kind": "youtube#playlist",
  "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,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    }
  },
  "status": {
    "privacyStatus": string
  },
  "contentDetails": {
    "itemCount": unsigned integer
  },
  "player": {
    "embedHtml": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": 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#playlist` olur.
`etag`	`etag` Bu kaynağın Etag'i.
`id`	`string` YouTube'un oynatma listesini benzersiz şekilde tanımlamak için kullandığı kimlik.
`snippet`	`object` `snippet` nesnesi, oynatma listesiyle ilgili temel ayrıntıları (ör. başlığı ve açıklaması) içerir.
`snippet.publishedAt`	`datetime` Oynatma listesinin oluşturulduğu tarih ve saat. Değer, ISO 8601 biçiminde belirtilir.
`snippet.channelId`	`string` YouTube'un oynatma listesini yayınlayan kanalı benzersiz şekilde tanımlamak için kullandığı kimlik.
`snippet.title`	`string` Oynatma listesinin başlığı.
`snippet.description`	`string` Oynatma listesinin açıklaması.
`snippet.thumbnails`	`object` Oynatma listesiyle 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` Videonun ait olduğu kanalın başlığıdır.
`snippet.tags[]`	`list` Bu özellik kullanımdan kaldırılmıştır. Oynatma listesiyle ilişkilendirilen anahtar kelime etiketleri.
`snippet.defaultLanguage`	`string` `playlist` kaynağının `snippet.title` ve `snippet.description` özelliklerindeki metnin dili.
`snippet.localized`	`object` `snippet.localized` nesnesi, oynatma listesi için yerelleştirilmiş bir başlık ve açıklama ya da oynatma listesinin meta verileri için varsayılan dildeki başlığı içerir. `playlists.list` isteği, yerelleştirilmiş metnin döndürülmesi gereken bir dili belirtmek için `hl` parametresini kullandıysa ve bu dilde yerelleştirilmiş metin mevcutsa yerelleştirilmiş metin kaynak snippet'te döndürülür. `hl` parametre değeri belirtilmezse veya bir değer belirtilir ancak belirtilen dil için yerelleştirilmiş meta veriler kullanılamazsa varsayılan dilin meta verileri döndürülür. Bu özellik salt okunur bir değer içeriyor. Yerelleştirilmiş başlıklar eklemek, güncellemek veya silmek için `localizations` nesnesini kullanın.
`snippet.localized.title`	`string` Yerelleştirilmiş oynatma listesi başlığı.
`snippet.localized.description`	`string` Yerelleştirilmiş oynatma listesi açıklaması.
`status`	`object` `status` nesnesi, oynatma listesinin durum bilgilerini içerir.
`status.privacyStatus`	`string` Oynatma listesinin gizlilik durumu. Bu mülk için geçerli değerler şunlardır: `private` `public` `unlisted`
`contentDetails`	`object` `contentDetails` nesnesi, oynatma listesindeki videoların sayısı da dahil olmak üzere oynatma listesi içeriğiyle ilgili bilgiler içerir.
`contentDetails.itemCount`	`unsigned integer` Oynatma listesindeki videoların sayısı.
`player`	`object` `player` nesnesi, oynatma listesini yerleştirilmiş oynatıcıda oynatmak için kullanabileceğiniz bilgileri içerir.
`player.embedHtml`	`string` Oynatma listesini oynatacak oynatıcıyı yerleştiren `<iframe>` etiketi.
`localizations`	`object` `localizations` nesnesi, oynatma listesinin meta verilerinin çevirilerini içerir.
`localizations.(key)`	`object` Anahtar değerle ilişkili yerelleştirilmiş metnin dili. Bu değer, BCP-47 dil kodu içeren bir dizedir.
`localizations.(key).title`	`string` Yerelleştirilmiş oynatma listesi başlığı.
`localizations.(key).description`	`string` Yerelleştirilmiş oynatma listesi açıklaması.