ChannelSections

channelSection kaynağı, bir dizi bir kanalın öne çıkarmayı seçtiği videolardır. Örneğin, bir bölümde kanalın en son yüklemeler, en popüler yüklemeler veya bir ya da daha fazla oynatma listesindeki videolar.

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ğrulanmış 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ı, bir 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ığı kimliktir.
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ığı kimliktir.
snippet.title string
Bölümün başlığı. snippet.type değerine sahip multiplePlaylists veya multipleChannels olan bir kanal bölümünün başlığını ayarlayabilirsiniz. Aslında, bu tür bölümlerden 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 yok sayılır.

Bu özelliğin değeri en fazla 100 karakter olabilir ve < ile < dışındaki geçerli tüm UTF-8 karakterlerini içerebilir.
snippet.position unsigned integer
Bölümün kanal sayfasındaki konumu. Bu özellik 0 tabanlı bir dizin kullanır. 0 değeri kanalda görünen ilk bölümü, 1 değeri ise ikinci bölümü tanımlar. Bu şekilde devam eder.

Kanal bölümü eklerken bu özellik için bir değer belirtmezseniz varsayılan davranış, yeni bölümü en son göstermektir.
contentDetails object
contentDetails nesnesi, kanal bölümünün içeriğiyle ilgili, oynatma listelerinin veya bölümde öne çıkan kanalların listesi gibi ayrıntıları 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 belirtilmelidir.
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 ve bu özellik diğer bölüm türleri için belirtilmemelidir. Listeye kendi kanalınızı ekleyemezsiniz.