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

Playlists

playlist kaynağı, bir YouTube oynatma listesini temsil eder. Oynatma listesi, sırayla 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 herkes tarafından görülebilir ancak oynatma listeleri herkese açık veya gizli olabilir.

YouTube, kanallara ait aşağıdaki gibi özel video koleksiyonlarını belirlemek için oynatma listelerini de kullanır:

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

Daha açık şekilde belirtmek gerekirse bu listeler; bir kişi, grup veya şirketin videolarının, oynatma listelerinin ve diğer YouTube bilgilerinin yer aldığı bir kanalla ilişkilendirilir. Bu listelerin her birinin oynatma listesi kimliklerini belirli bir kanal için channel resource kaynağından 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 listelerden öğe kaldırabilirsiniz.

Yöntemler

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

list: API isteği 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 veya benzersiz kimliklerine göre bir ya da daha fazla oynatma listesini alabilirsiniz. Hemen deneyin.
ekle: Oynatma listesi oluşturur. Hemen deneyin.
güncelle: Oynatma listesini değiştirir. Örneğin, oynatma listesinin başlığını, açıklamasını veya gizlilik durumunu değiştirebilirsiniz. Hemen deneyin.
sil: Oynatma listesini siler. Hemen deneyin.

Kaynak temsili

Aşağıdaki JSON yapısı, bir 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,
    "podcastStatus": enum
  },
  "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ığı kimliktir.
`snippet`	`object` `snippet` nesnesi, oynatma listesiyle ilgili başlık ve açıklama gibi temel ayrıntıları 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ığı kimliktir.
`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ıdır, değer ise küçük resim hakkında başka bilgileri içeren bir nesnedir.
`snippet.thumbnails.(key)`	`object` Geçerli anahtar değerleri şunlardır: `default`: Varsayılan küçük resimdir. Bir videonun (veya oynatma listesi öğesi ya da arama sonucu gibi bir videoya atıfta bulunan bir kaynak) varsayılan küçük resmi 120 piksel genişliğinde ve 90 piksel uzunluğundadır. 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ü sürümü. Bir video (veya videoya atıfta bulunan bir kaynak) için bu görüntü 320 piksel genişliğinde ve 180 piksel yüksekliğindedir. 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 videoya atıfta bulunan bir kaynak) için bu görüntü 480 piksel genişliğinde ve 360 piksel yüksekliğindedir. Bir kanal 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 da yüksek çözünürlüklü sürümü. Bu görsel, oynatma listesi öğeleri veya arama sonuçları gibi videolarla ilgili bazı videolar ve diğer kaynaklar için kullanılabilir. Bu görselin genişliği 640 piksel, yüksekliği 480 pikseldir. `maxres`: Küçük resmin en yüksek çözünürlüklü sürümü. Bu resim boyutu, oynatma listesi öğeleri veya arama sonuçları gibi videolara atıfta bulunan bazı videolar ve diğer kaynaklar için kullanılabilir. Bu görsel 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` Videonun ait olduğu kanalın başlığı.
`snippet.tags[]`	`list` Bu özelliğin desteği sonlandırıldı. 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 veya oynatma listesinin meta verileri için varsayılan dilde başlık içerir. `playlists.list` isteği, yerelleştirilmiş metnin döndürülmesi gereken dili belirtmek için `hl` parametresini kullanıyorsa ve yerelleştirilmiş metin bu dilde kullanılabiliyorsa kaynak snippet'inde yerelleştirilmiş metin döndürülür. Bir `hl` parametre değeri belirtilmemiş veya bir değer belirtilmişse ancak belirtilen dil için yerelleştirilmiş meta veriler mevcut değilse varsayılan dilin meta verileri döndürülür. Özellik, salt okunur bir değer içerir. 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 tesis için geçerli değerler şunlardır: `private` `public` `unlisted`
`status.podcastStatus`	`string` Oynatma listesinin podcast durumu. Değer `enabled` ise oynatma listesi bir podcast programı olarak işaretlenir. Oynatma listesinin podcast durumunu `enabled` olarak ayarlamak için oynatma listesinde oynatma listesi resmi olmalıdır. Bu tesis için geçerli değerler şunlardır: `enabled` `disabled` `unspecified`
`contentDetails`	`object` `contentDetails` nesnesi, oynatma listesindeki video sayısı da dahil olmak üzere oynatma listesi içeriğiyle ilgili bilgileri içerir.
`contentDetails.itemCount`	`unsigned integer` Oynatma listesindeki videoların sayısı.
`player`	`object` `player` nesnesi, oynatma listesini yerleşik bir oynatıcıda oynatmak için kullanacağınız bilgileri içerir.
`player.embedHtml`	`string` Oynatma listesini oynatacak bir oynatıcı yerleştiren `<iframe>` etiketi.
`localizations`	`object` `localizations` nesnesi, oynatma listesinin meta verilerinin çevirilerini içerir.
`localizations.(key)`	`object` Anahtar değeriyle ilişkili yerelleştirilmiş metnin dili. Değer, BCP-47 dil kodunu içeren bir dizedir.
`localizations.(key).title`	`string` Yerelleştirilmiş oynatma listesi başlığı.
`localizations.(key).description`	`string` Yerelleştirilmiş oynatma listesi açıklaması.