ChannelSections

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

Channel dapat membuat maksimal 10 galeri.

Metode

API ini mendukung metode berikut untuk resource channelSections:

list
Menampilkan daftar channelSection resource yang cocok dengan kriteria permintaan API. Coba sekarang.
sisipkan
Menambahkan bagian saluran ke saluran pengguna yang diautentikasi. Channel dapat membuat maksimal 10 galeri. Coba sekarang.
info terbaru
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 channel.

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 secara unik channel yang memublikasikan bagian channel.
snippet.title string
Judul bagian. Anda hanya dapat menyetel judul bagian saluran yang memiliki nilai snippet.type multiplePlaylists atau multipleChannels, dan faktanya, Anda harus menentukan judul saat menyisipkan atau memperbarui salah satu jenis bagian tersebut. Jika Anda menentukan judul untuk jenis bagian saluran lainnya, nilai akan diabaikan.

Nilai properti ini memiliki panjang maksimal 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 saluran, perilaku defaultnya adalah menampilkan bagian baru di akhir.
contentDetails object
Objek contentDetails berisi detail tentang konten bagian channel, seperti daftar playlist atau channel yang ditampilkan di bagian tersebut.
contentDetails.playlists[] list
Daftar satu atau beberapa ID playlist yang ditampilkan di bagian channel. Anda harus menentukan daftar ID playlist jika properti snippet.type aset channelSection adalah singlePlaylist atau multiplePlaylists, dan properti ini tidak boleh ditentukan untuk jenis bagian lain. Jika jenisnya singlePlaylist, daftar ini harus menentukan satu ID playlist.
contentDetails.channels[] list
Daftar satu atau beberapa ID channel yang ditampilkan di bagian channel. Anda harus menentukan daftar ID saluran jika properti snippet.type aset channelSection adalah multipleChannels, dan properti ini tidak boleh ditentukan untuk jenis bagian lainnya. Anda tidak dapat menyertakan channel Anda sendiri dalam daftar.