ChannelSections: insert

認証済みユーザーのチャンネルにチャンネル セクションを追加します。チャンネルで作成できる本棚は 10 個までです。

割り当ての影響: このメソッドを呼び出すと、割り当てコストは 50 単位になります。

一般的なユースケース

リクエスト

HTTP リクエスト

POST https://www.googleapis.com/youtube/v3/channelSections

承認

このリクエストは、少なくとも次のうち 1 つのスコープでの承認が必要です(認証と承認の詳細をご確認ください)。

範囲
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

パラメータ

次の表に、このクエリがサポートするパラメータを示します。このリストのパラメータはすべてクエリ パラメータです。

パラメータ
必須パラメータ
part string
このオペレーションでは、part パラメータに 2 つの目的があります。書き込みオペレーションで設定するプロパティと、API レスポンスに含まれるプロパティを指定します。

次のリストに、パラメータ値に含めることができる part 名を示します。
  • contentDetails
  • id
  • snippet
オプション パラメータ
onBehalfOfContentOwner string
このパラメータは、適切に承認されたリクエストでのみ使用できます。注: このパラメータは、YouTube コンテンツ パートナー専用です。

onBehalfOfContentOwner パラメータは、パラメータ値で指定されたコンテンツ所有者に代わって行動する YouTube CMS ユーザーを識別するリクエストの認証情報です。このパラメータは、複数の YouTube チャンネルを所有、管理している YouTube コンテンツ パートナーを対象にしています。このパラメータを使用すると、コンテンツ所有者は一度認証されれば、すべての動画やチャンネル データにアクセスできるようになります。チャンネルごとに認証情報を指定する必要はありません。ユーザー認証に使用する CMS アカウントは、指定された YouTube コンテンツ所有者にリンクされていなければなりません。
onBehalfOfContentOwnerChannel string
このパラメータは、適切に承認されたリクエストでのみ使用できます。注: このパラメータは、YouTube コンテンツ パートナー専用です。

onBehalfOfContentOwnerChannel パラメータは、動画を追加するチャンネルの YouTube チャンネル ID を指定します。このパラメータは、リクエストで onBehalfOfContentOwner パラメータの値を指定するときに必要です。このパラメータとの組み合わせでのみ使用できます。また、このリクエストは onBehalfOfContentOwner パラメータで指定されたコンテンツ所有者にリンクされている CMS アカウントを使用して承認される必要があります。最後に、onBehalfOfContentOwnerChannel パラメータの値で指定するチャンネルは、onBehalfOfContentOwner で指定するコンテンツ所有者にリンクする必要があります。

このパラメータは、さまざまな YouTube チャンネルを所有、管理している YouTube コンテンツ パートナーを対象としています。このパラメータを使用すると、コンテンツ所有者は一度認証されれば、パラメータ値で指定されたチャンネルの代わりにアクションを実行できるようになります。チャンネルごとに認証情報を指定する必要はありません。

リクエスト本文

リクエストの本文に channelSection リソースを指定します。対象リソース:

  • 以下のプロパティの値を指定する必要があります。

    • snippet.type

  • 以下のプロパティの値を設定することができます。

    • snippet.type
    • snippet.title
    • snippet.position
    • contentDetails.playlists[]
    • contentDetails.channels[]

レスポンス

成功すると、このメソッドはレスポンスの本文で channelSection リソースを返します。

エラー

次の表に、このメソッドの呼び出しに応じて API から返される可能性のあるエラー メッセージを示します。詳細については、エラー メッセージのドキュメントを参照してください。

エラーのタイプ エラーの詳細 説明
badRequest (400) notEditable このチャンネル セクションは作成できません。
badRequest (400) typeRequired channelSection リソースは、snippet.type フィールドの値を指定する必要があります。
forbidden (403) channelSectionForbidden リクエストが適切に認証されていないか、このチャネルではサポートされていません。
invalidValue (400) channelNotActive 指定されたチャネルのうち少なくとも 1 つがアクティブではありません。
invalidValue (400) channelsDuplicated 重複するチャンネルが指定されているため、リクエストは失敗しました。
invalidValue (400) channelsNeeded snippet.type プロパティの値が multipleChannels の場合は、contentDetails.channels[] プロパティを指定し、少なくとも 1 つのチャンネルを指定する必要があります。
invalidValue (400) channelsNotExpected リクエストで提供されたリソースで contentDetails.channels[] プロパティの値が指定されていますが、このタイプのチャンネル セクションにはチャンネルを指定することができません。
invalidValue (400) contentDetailsNeeded 挿入するリソースには、このタイプのチャンネル セクションの contentDetails オブジェクトが含まれている必要があります。
invalidValue (400) inValidPosition snippet.position プロパティに無効な値が含まれています。
invalidValue (400) maxChannelSectionExceeded このチャンネルはセクション数が上限に達しているため、リクエストを完了できません。
invalidValue (400) maxChannelsExceeded チャンネル セクションに大量のチャンネルを追加しようとしたため、リクエストは失敗しました。
invalidValue (400) maxPlaylistExceeded チャンネル セクションに再生リストが多すぎるため、リクエストを処理できませんでした。
invalidValue (400) onePlaylistNeeded snippet.type プロパティの値が singlePlaylist の場合、contentDetails.playlists[] プロパティにはプレイリストを 1 つだけ指定する必要があります。
invalidValue (400) ownChannelInChannels 自分のチャンネルに表示されるチャンネル セクションに自分のチャンネルを含めることはできません。
invalidValue (400) playlistIsPrivate 指定したプレイリストのうち 1 つ以上が非公開に設定されているため、チャンネル セクションに追加できません。
invalidValue (400) playlistsDuplicated 重複プレイリストが指定されているため、リクエストは失敗しました。
invalidValue (400) playlistsNeeded snippet.type プロパティの値が singlePlaylist または multiplePlaylists の場合は、contentDetails.playlists[] プロパティを指定する必要があります。
invalidValue (400) playlistsNotExpected リクエストで提供されたリソースで contentDetails.playlists[] プロパティの値が指定されていますが、このタイプのチャンネル セクションに再生リストは必要ありません。
invalidValue (400) snippetNeeded チャンネル セクションを作成するには、snippet を指定する必要があります。
invalidValue (400) titleLengthExceeded snippet.title プロパティの値が長すぎます。
invalidValue (400) titleRequired snippet.type プロパティの値が multiplePlaylists または multipleChannels の場合は、snippet.title プロパティの値を指定してセクションのタイトルを設定する必要があります。
notFound (404) channelNotFound 指定された 1 つ以上のチャネルが見つかりません。
notFound (404) playlistNotFound 指定したプレイリストが見つかりません。

実習

APIs Explorer を使用してこの API を呼び出し、API のリクエストとレスポンスを確認します。