ChannelSections

channelSection リソースには、チャンネルがおすすめとして選択した一連の動画に関する情報が含まれます。たとえば、チャンネルの最新アップロード、特に人気の高いアップロード、1 つまたは複数の再生リストの動画などをセクションとして表示できます。

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

Methods

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
チャンネル セクションのタイプ。

このプロパティの有効な値は次のとおりです。
  • 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 のリストを指定する必要があります。他のタイプのセクションにはこのプロパティを指定しないでください。自分のチャンネルをリストに含めることはできません。