channelSection
kaynağı, kanalın öne çıkarmayı seçtiği bir grup video ile ilgili bilgileri içerir. Örneğin, bir bölümde kanalın en son yüklemeleri, en popüler yüklemeleri ya da bir veya daha fazla oynatma listesindeki videolar öne çıkarılabilir.
Bir kanal en fazla 10 raf oluşturabilir.
Yöntemler
API, channelSections
kaynakları için aşağıdaki yöntemleri destekler:
- list
- API isteği ölçütleriyle eşleşen
channelSection
kaynağın listesini döndürür. Hemen deneyin. - ekle
- Kimliği doğrulanan kullanıcının kanalına bir kanal bölümü ekler. Bir kanal en fazla 10 raf oluşturabilir. Hemen deneyin.
- güncelle
- Bir kanal bölümünü günceller. Hemen deneyin.
- sil
- Bir kanal bölümünü siler. Hemen deneyin.
Kaynak temsili
Aşağıdaki JSON yapısı, channelSections
kaynağının biçimini gösterir:
{ "kind": "youtube#channelSection", "etag": etag, "id": string, "snippet": { "type": string, "channelId": string, "title": string, "position": unsigned integer }, "contentDetails": { "playlists": [ string ], "channels": [ 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#channelSection olur. |
etag |
etag Bu kaynağın Etag'i. |
id |
string YouTube'un kanal bölümünü benzersiz şekilde tanımlamak için kullandığı kimlik. |
snippet |
object snippet nesnesi, kanal bölümü hakkında türü ve başlığı gibi temel ayrıntıları içerir. |
snippet.type |
string Kanal bölümünün türü. Bu mülk için geçerli değerler şunlardır:
|
snippet.channelId |
string YouTube'un, kanal bölümünü yayınlayan kanalı benzersiz şekilde tanımlamak için kullandığı kimliktir. |
snippet.title |
string Bölümün başlığı. Yalnızca snippet.type değeri multiplePlaylists veya multipleChannels olan bir kanal bölümünün başlığını ayarlayabilirsiniz. Hatta bu tür bölümlerden herhangi birini eklerken veya güncellerken bir başlık belirtmeniz gerekir. Diğer kanal bölümü türleri için başlık belirtirseniz değer yoksayılır.Bu mülkün değeri en fazla 100 karakter uzunluğunda olabilir ve < ve > dışındaki geçerli tüm UTF-8 karakterlerini içerebilir. |
snippet.position |
unsigned integer Bölümün kanal sayfasındaki konumu. Bu mülkte 0 tabanlı bir dizin kullanılmaktadır. 0 değeri kanalda görünen ilk bölümü, 1 değeri ikinci bölümü ve bu şekilde devam eder.Bir kanal bölümü eklerken bu özellik için bir değer belirtmezseniz varsayılan davranış, yeni bölümün en son görüntülenmesi olur. |
contentDetails |
object contentDetails nesnesi, kanal bölümünün içeriğiyle ilgili ayrıntıları (ör. bölümde öne çıkan oynatma listeleri veya kanalların listesi) içerir. |
contentDetails.playlists[] |
list Bir kanal bölümünde öne çıkan bir veya daha fazla oynatma listesi kimliğinin listesi. channelSection kaynağının snippet.type özelliği singlePlaylist veya multiplePlaylists ise bir oynatma listesi kimlikleri listesi belirtmeniz gerekir ve bu özellik diğer bölüm türleri için belirtilmemelidir. Tür singlePlaylist ise bu listede tam olarak bir oynatma listesi kimliği belirtmelidir. |
contentDetails.channels[] |
list Bir kanal bölümünde öne çıkan bir veya daha fazla kanal kimliğinin listesi. channelSection kaynağının snippet.type özelliği multipleChannels ise kanal kimlikleri listesi belirtmeniz gerekir. Diğer bölüm türleri için bu özellik belirtilmemelidir. Kendi kanalınızı listeye ekleyemezsiniz. |