channelSection
kaynağı, bir kanalın öne çıkarmayı tercih ettiği videoyla ilgili bilgiler içerir. Örneğin, bir bölümde kanalın en son yüklemeleri, en popüler yüklemeleri veya bir veya daha fazla oynatma listesindeki videolar yer alabilir.
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
kaynakların listesini döndürür. Hemen deneyin. - ekle
- Kimliği doğrulanmış kullanıcının kanalına kanal bölümü ekler. Kanallar en fazla 10 raf oluşturabilir. Hemen deneyin.
- güncelle
- Kanal bölümünü günceller. Hemen deneyin.
- sil
- Kanal bölümünü siler. Hemen deneyin.
Kaynak temsili
Aşağıdaki JSON yapısı, bir channelSections
kaynağının biçimini göstermektedir:
{ "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 olacak. |
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üyle ilgili, 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ığı kimlik. |
snippet.title |
string Bölümün başlığı. Yalnızca snippet.type veya multiplePlaylists ya da multipleChannels değerine sahip bir kanal bölümünün başlığını ayarlayabilirsiniz. Bu tür bölümlerden herhangi birini eklerken veya güncellerken aslında bir başlık belirtmelisiniz. Diğer kanal bölümü türleri için başlık belirtirseniz değer dikkate alınmaz.Bu özelliğin değeri en fazla 100 karakter olabilir ve < ve > dışındaki tüm geçerli UTF-8 karakterleri içerebilir. |
snippet.position |
unsigned integer Bölümün kanal sayfasındaki konumu. Bu mülk 0 tabanlı bir dizin kullanıyor. 0 değeri, kanalda görünen ilk bölümü, 1 değeri ise ikinci bölümü tanımlar ve bu, bu şekilde devam eder.Kanal bölümünü eklerken bu özellik için bir değer belirtmezseniz varsayılan bölüm yeni bölümü en son görüntülemektir. |
contentDetails |
object contentDetails nesnesi, kanal bölümünün içeriğiyle ilgili ayrıntıları (ör. bölümde yer alan 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 oynatma listesi kimliklerinin listesini belirtmelisiniz. 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 belirtilmelidir. |
contentDetails.channels[] |
list Kanal bölümünde yer alan bir veya daha fazla kanal kimliğinin listesi. channelSection kaynağının snippet.type özelliği multipleChannels ise kanal kimlikleri listesini belirtmelisiniz. Bu özellik, diğer bölüm türleri için belirtilmemelidir. Listeye kendi kanalınızı ekleyemezsiniz. |