ChannelSections

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:
  • allPlaylists
  • completedEvents
  • liveEvents
  • multipleChannels
  • multiplePlaylists
  • popularUploads
  • recentUploads
  • singlePlaylist
  • subscriptions
  • upcomingEvents
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.