channelSection
リソースには、一連の情報に関する情報が含まれます。
おすすめ動画が表示されますたとえば、1 つのセクションにチャンネルの
最新の動画、最も人気のある動画、複数の再生リストの動画などが表示されます。
1 つのチャンネルに最大 10 個のセクションを作成できます。
メソッド
この API では、channelSections
リソースについて次のメソッドがサポートされています。
リソース表現
次の JSON 構造は、channelSections
リソースの形式を示しています。
{ "kind": "youtube#channelSection", "etag": etag, "id": string, "snippet": { "type": string, "channelId": string, "title": string, "position": unsigned integer }, "contentDetails": { "playlists": [ string ], "channels": [ string ] } }
プロパティ
次の表は、このリソースで使用されているプロパティの定義を示したものです。
プロパティ | |
---|---|
kind |
string API リソースのタイプを指定します。値は youtube#channelSection です。 |
etag |
etag このリソースの ETag。 |
id |
string チャンネル セクションを一意に識別するために YouTube によって使用される ID。 |
snippet |
object snippet オブジェクトには、タイプやタイトルなど、チャンネル セクションに関する基本情報が格納されます。 |
snippet.type |
string チャンネル セクションのタイプ。 このプロパティで有効な値は次のとおりです。 <ph type="x-smartling-placeholder">
|
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 のリストを指定する必要があります。他のタイプのセクションではこのプロパティを指定しないでください。自分のチャンネルをリストに含めることはできません。 |