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:
|
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. |