ChannelSections

Resource channelSection berisi informasi tentang sekumpulan video yang telah dipilih oleh channel untuk ditampilkan. Misalnya, bagian dapat menampilkan upload terbaru channel, upload terpopuler, atau video dari satu atau beberapa playlist.

Channel dapat membuat maksimum 10 galeri.

Metode

API mendukung metode berikut untuk resource channelSections:

list
Menampilkan daftar resource channelSection yang cocok dengan kriteria permintaan API. Coba sekarang.
masukkan
Menambahkan bagian channel ke channel pengguna yang diautentikasi. Channel dapat membuat maksimal 10 galeri. Coba sekarang.
perbarui
Memperbarui bagian channel. Coba sekarang.
hapus
Menghapus bagian channel. Coba sekarang.

Representasi resource

Struktur JSON berikut menunjukkan format resource channelSections:

{
  "kind": "youtube#channelSection",
  "etag": etag,
  "id": string,
  "snippet": {
    "type": string,
    "channelId": string,
    "title": string,
    "position": unsigned integer
  },
  "contentDetails": {
    "playlists": [
      string
    ],
    "channels": [
      string
    ]
  }
}

Properti

Tabel berikut menentukan properti yang muncul di resource ini:

Properti
kind string
Mengidentifikasi jenis resource API. Nilainya adalah youtube#channelSection.
etag etag
Etag resource ini.
id string
ID yang digunakan YouTube untuk mengidentifikasi bagian channel secara unik.
snippet object
Objek snippet berisi detail dasar tentang bagian saluran, seperti jenis dan judulnya.
snippet.type string
Jenis bagian saluran.

Nilai yang valid untuk properti ini adalah:
  • allPlaylists
  • completedEvents
  • liveEvents
  • multipleChannels
  • multiplePlaylists
  • popularUploads
  • recentUploads
  • singlePlaylist
  • subscriptions
  • upcomingEvents
snippet.channelId string
ID yang digunakan YouTube untuk mengidentifikasi channel yang memublikasikan bagian channel secara unik.
snippet.title string
Judul bagian. Anda hanya dapat menetapkan judul bagian channel yang memiliki nilai snippet.type dari multiplePlaylists atau multipleChannels, dan, pada kenyataannya, Anda harus menentukan judul saat menyisipkan atau memperbarui salah satu jenis bagian tersebut. Jika Anda menentukan judul untuk jenis bagian saluran lain, nilai ini akan diabaikan.

Nilai properti ini memiliki panjang maksimum 100 karakter dan dapat berisi semua karakter UTF-8 yang valid kecuali < dan >.
snippet.position unsigned integer
Posisi bagian di halaman channel. Properti ini menggunakan indeks berbasis 0. Nilai 0 mengidentifikasi bagian pertama yang muncul di saluran, nilai 1 mengidentifikasi bagian kedua, dan seterusnya.

Jika Anda tidak menentukan nilai untuk properti ini saat menyisipkan bagian channel, perilaku defaultnya adalah menampilkan bagian baru.
contentDetails object
Objek contentDetails berisi detail tentang konten bagian channel, seperti daftar playlist atau channel yang ditampilkan di bagian tersebut.
contentDetails.playlists[] list
Daftar dari satu atau beberapa ID playlist yang ditampilkan di bagian channel. Anda harus menentukan daftar ID playlist jika properti snippet.type resource channelSection adalah singlePlaylist atau multiplePlaylists, dan properti ini tidak boleh ditentukan untuk jenis bagian lain. Jika jenisnya adalah singlePlaylist, daftar ini harus menentukan tepat satu ID playlist.
contentDetails.channels[] list
Daftar dari satu atau beberapa ID channel yang ditampilkan di bagian channel. Anda harus menentukan daftar ID saluran jika properti snippet.type resource channelSection adalah multipleChannels, dan properti ini tidak boleh ditentukan untuk jenis bagian lain. Anda tidak dapat menyertakan channel sendiri dalam daftar.