ChannelSections

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:
  • 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ığı 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.