ChannelSections

channelSection リソースには、一連の情報に関する情報が含まれます。 おすすめ動画が表示されますたとえば、1 つのセクションにチャンネルの 最新の動画、最も人気のある動画、複数の再生リストの動画などが表示されます。

1 つのチャンネルに最大 10 個のセクションを作成できます。

メソッド

この API では、channelSections リソースについて次のメソッドがサポートされています。

list
API リクエスト条件に一致する channelSection リソースのリストを返します。 こちらから今すぐお試しください。
insert
認証されたユーザーのチャンネルにチャンネル セクションを追加します。1 つのチャンネルに最大 10 個のセクションを作成できます。 今すぐ試す
update
チャンネル セクションを更新します。 今すぐ試す
delete
チャンネルのセクションを削除します。 今すぐ試す

リソース表現

次の 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">
    </ph>
  • allPlaylists
  • completedEvents
  • liveEvents
  • multipleChannels
  • multiplePlaylists
  • popularUploads
  • recentUploads
  • singlePlaylist
  • subscriptions
  • upcomingEvents
snippet.channelId string
チャンネル セクションを公開したチャンネルを一意に識別するために YouTube によって使用される ID。
snippet.title string
セクションのタイトル。設定できるのは、snippet.type の値が multiplePlaylists または multipleChannels のチャンネル セクションのタイトルのみです。実際に、これらのタイプのセクションを挿入または更新するときは、タイトルを指定する必要があります。他のタイプのチャンネル セクションにタイトルを指定した場合、値は無視されます。

このプロパティの値の最大長は 100 文字で、&lt;&lt; を除くすべての有効な 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 のリストを指定する必要があります。他のタイプのセクションではこのプロパティを指定しないでください。自分のチャンネルをリストに含めることはできません。