ChannelSections
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
channelSection
リソースには、一連の情報に関する情報が含まれます。
おすすめ動画が表示されますたとえば、1 つのセクションにチャンネルの
最新の動画、最も人気のある動画、複数の再生リストの動画などが表示されます。
1 つのチャンネルに最大 10 個のセクションを作成できます。
メソッド
この API では、channelSections
リソースについて次のメソッドがサポートされています。
- list
- API リクエスト条件に一致する
channelSection
リソースのリストを返します。
こちらから今すぐお試しください。
- insert
- 認証されたユーザーのチャンネルにチャンネル セクションを追加します。1 つのチャンネルに最大 10 個のセクションを作成できます。
今すぐ試す
- update
- チャンネル セクションを更新します。
今すぐ試す
- delete
- チャンネルのセクションを削除します。
今すぐ試す
プロパティ
次の表は、このリソースで使用されているプロパティの定義を示したものです。
プロパティ |
kind |
string
API リソースのタイプを指定します。値は youtube#channelSection です。 |
etag |
etag
このリソースの ETag。 |
id |
string
チャンネル セクションを一意に識別するために YouTube によって使用される ID。 |
snippet |
object
snippet オブジェクトには、タイプやタイトルなど、チャンネル セクションに関する基本情報が格納されます。 |
snippet.type |
string
チャンネル セクションのタイプ。
このプロパティで有効な値は次のとおりです。
<ph type="x-smartling-placeholder"></ph>
allPlaylists
completedEvents
liveEvents
multipleChannels
multiplePlaylists
popularUploads
recentUploads
singlePlaylist
subscriptions
upcomingEvents
|
snippet.channelId |
string
チャンネル セクションを公開したチャンネルを一意に識別するために YouTube によって使用される ID。 |
snippet.title |
string
セクションのタイトル。設定できるのは、snippet.type の値が multiplePlaylists または multipleChannels のチャンネル セクションのタイトルのみです。実際に、これらのタイプのセクションを挿入または更新するときは、タイトルを指定する必要があります。他のタイプのチャンネル セクションにタイトルを指定した場合、値は無視されます。
このプロパティの値の最大長は 100 文字で、< と < を除くすべての有効な UTF-8 文字を含めることができます。 |
snippet.position |
unsigned integer
チャンネル ページでのセクションの位置。このプロパティは 0 から始まるインデックスを使用します。値 0 はチャンネルに最初に表示されるセクション、値 1 は 2 番目のセクションを識別するというように続きます。
チャンネル セクションの挿入時にこのプロパティの値を指定しない場合、デフォルトの動作として、新しいセクションが最後に表示されます。 |
contentDetails |
object
contentDetails オブジェクトには、チャンネル セクションのコンテンツに関する詳細情報(セクションに表示される再生リストやチャンネルのリストなど)が含まれます。 |
contentDetails.playlists[] |
list
チャンネル セクションで紹介されている 1 つ以上の再生リスト ID のリスト。channelSection リソースの snippet.type プロパティが singlePlaylist または multiplePlaylists の場合は、再生リスト ID のリストを指定する必要があります。他のタイプのセクションではこのプロパティを指定しないでください。タイプが singlePlaylist の場合、このリストには再生リスト ID を 1 つだけ指定する必要があります。 |
contentDetails.channels[] |
list
チャンネルのセクションに表示される 1 つ以上のチャンネル ID のリスト。channelSection リソースの snippet.type プロパティが multipleChannels の場合は、チャンネル ID のリストを指定する必要があります。他のタイプのセクションではこのプロパティを指定しないでください。自分のチャンネルをリストに含めることはできません。 |
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-08-21 UTC。
[null,null,["最終更新日 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. |"]]