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。
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["必要な情報がない","missingTheInformationINeed","thumb-down"],["複雑すぎる / 手順が多すぎる","tooComplicatedTooManySteps","thumb-down"],["最新ではない","outOfDate","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["サンプル / コードに問題がある","samplesCodeIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 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,[]]