ChannelSections

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

Satu 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 telah diautentikasi. Satu channel dapat membuat maksimal 10 galeri. Coba sekarang.
perbarui
Memperbarui bagian saluran. Coba sekarang.
hapus
Menghapus bagian channel. Coba sekarang.

Representasi resource

Struktur JSON berikut menampilkan 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 mendefinisikan properti yang muncul di resource ini:

Properti
kind string
Mengidentifikasi jenis resource API. Nilainya akan berupa 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 channel, 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, sebenarnya, Anda harus menentukan judul saat menyisipkan atau memperbarui salah satu jenis bagian tersebut. Jika Anda menentukan judul untuk jenis bagian saluran yang 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 pada saluran, nilai 1 mengidentifikasi bagian kedua, dan seterusnya.

Jika Anda tidak menentukan nilai untuk properti ini saat menyisipkan bagian saluran, perilaku default-nya 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 resource 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 dengan tepat.
contentDetails.channels[] list
Daftar satu atau beberapa ID channel yang ditampilkan di bagian channel. Anda harus menentukan daftar ID channel jika properti snippet.type resource channelSection adalah multipleChannels, dan properti ini tidak boleh ditentukan untuk jenis bagian lain. Anda tidak dapat menyertakan channel Anda sendiri dalam daftar tersebut.