Kami memperbarui Data API agar sesuai dengan cara YouTube menghitung penayangan untuk Shorts.
Pelajari lebih lanjut
ChannelSections
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
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.
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:
allPlaylistscompletedEventsliveEventsmultipleChannelsmultiplePlaylistspopularUploadsrecentUploadssinglePlaylistsubscriptionsupcomingEvents
|
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. |
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-21 UTC.
[null,null,["Terakhir diperbarui pada 2025-08-21 UTC."],[[["\u003cp\u003eA \u003ccode\u003echannelSection\u003c/code\u003e resource contains information about a set of videos that a channel features, such as latest uploads, popular uploads, or playlists.\u003c/p\u003e\n"],["\u003cp\u003eChannels can manage their featured videos using the API, which allows creating, listing, updating, and deleting \u003ccode\u003echannelSection\u003c/code\u003e resources.\u003c/p\u003e\n"],["\u003cp\u003eA channel can have a maximum of 10 sections, each with a specified type like \u003ccode\u003esinglePlaylist\u003c/code\u003e, \u003ccode\u003emultipleChannels\u003c/code\u003e, or \u003ccode\u003epopularUploads\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eEach \u003ccode\u003echannelSection\u003c/code\u003e has properties such as \u003ccode\u003ekind\u003c/code\u003e, \u003ccode\u003eetag\u003c/code\u003e, \u003ccode\u003eid\u003c/code\u003e, \u003ccode\u003esnippet\u003c/code\u003e, and \u003ccode\u003econtentDetails\u003c/code\u003e, which specify details about the section and its contents.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003econtentDetails\u003c/code\u003e property can contain a list of either playlists or channels featured in the section, depending on the \u003ccode\u003esnippet.type\u003c/code\u003e property.\u003c/p\u003e\n"]]],["Channel sections feature a curated set of videos, like latest or popular uploads, or playlists. API methods allow listing, inserting, updating, and deleting these sections. A channel can have up to 10 sections. Each section contains `snippet` and `contentDetails` objects which describes the type, title, position, and the featured channels/playlists. The type can be single or multiple playlists, or channels, amongst others. Specific titles are required for some types and cannot include \"\u003c\" or \"\u003e\".\n"],null,["# ChannelSections\n\nA **channelSection** resource contains information about a set of\nvideos that a channel has chosen to feature. For example, a section could feature a channel's\nlatest uploads, most popular uploads, or videos from one or more playlists. \n\n\nA channel can create a maximum of 10 shelves.\n\nMethods\n-------\n\nThe API supports the following methods for `channelSections` resources:\n\n[list](/youtube/v3/docs/channelSections/list)\n: Returns a list of `channelSection` resources that match the API request criteria.\n [Try it now](/youtube/v3/docs/channelSections/list#usage).\n\n[insert](/youtube/v3/docs/channelSections/insert)\n: Adds a channel section to the authenticated user's channel. A channel can create a maximum of 10 shelves.\n [Try it now](/youtube/v3/docs/channelSections/insert#usage).\n\n[update](/youtube/v3/docs/channelSections/update)\n: Updates a channel section.\n [Try it now](/youtube/v3/docs/channelSections/update#usage).\n\n[delete](/youtube/v3/docs/channelSections/delete)\n: Deletes a channel section.\n [Try it now](/youtube/v3/docs/channelSections/delete#usage).\n\nResource representation\n-----------------------\n\nThe following JSON structure shows the format of a `channelSections` resource: \n\n```carbon\n{\n \"#kind\": \"youtube#channelSection\",\n \"#etag\": etag,\n \"#id\": string,\n \"#snippet\": {\n \"#snippet.type\": string,\n \"#snippet.channelId\": string,\n \"#snippet.title\": string,\n \"#snippet.position\": unsigned integer\n },\n \"#contentDetails\": {\n \"#contentDetails.playlists[]\": [\n string\n ],\n \"#contentDetails.channels[]\": [\n string\n ]\n }\n}\n```\n\n### Properties\n\nThe following table defines the properties that appear in this resource:\n\n| Properties ||\n|------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies the API resource's type. The value will be `youtube#channelSection`. |\n| `etag` | `etag` The Etag of this resource. |\n| `id` | `string` The ID that YouTube uses to uniquely identify the channel section. |\n| `snippet` | `object` The `snippet` object contains basic details about the channel section, such as its type and title. |\n| snippet.`type` | `string` The channel section's type. Valid values for this property are: - `allPlaylists` - `completedEvents` - `liveEvents` - `multipleChannels` - `multiplePlaylists` - `popularUploads` - `recentUploads` - `singlePlaylist` - `subscriptions` - `upcomingEvents` |\n| snippet.`channelId` | `string` The ID that YouTube uses to uniquely identify the channel that published the channel section. |\n| snippet.`title` | `string` The section's title. You can only set the title of a channel section that has a `snippet.type` value of either `multiplePlaylists` or `multipleChannels`, and, in fact, you must specify a title when inserting or updating either of those types of sections. If you specify a title for other types of channel sections, the value will be ignored. This property's value has a maximum length of 100 characters and may contain all valid UTF-8 characters except **\\\u003c** and **\\\u003e**. |\n| snippet.`position` | `unsigned integer` The section's position on the channel page. This property uses a 0-based index. A value of `0` identifies the first section that appears on the channel, a value of `1` identifies the second section, and so forth. If you do not specify a value for this property when inserting a channel section, the default behavior is to display the new section last. |\n| `contentDetails` | `object` The `contentDetails` object contains details about the channel section's content, such as a list of playlists or channels featured in the section. |\n| contentDetails.`playlists[]` | `list` A list of one or more playlist IDs that are featured in a channel section. You must specify a list of playlist IDs if the `channelSection` resource's `snippet.type` property is either `singlePlaylist` or `multiplePlaylists`, and this property should not be specified for other types of sections. If the type is `singlePlaylist`, this list must specify exactly one playlist ID. |\n| contentDetails.`channels[]` | `list` A list of one or more channel IDs that are featured in a channel section. You must specify a list of channel IDs if the `channelSection` resource's `snippet.type` property is `multipleChannels`, and this property should not be specified for other types of sections. You cannot include your own channel in the list. |"]]
