PlaylistItems: insert

再生リストにリソースを追加します。 今すぐ試す。

リクエスト

HTTP リクエスト

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

承認

このリクエストは、最低でも以下のスコープの 1 つによって承認される必要があります（認証と承認の詳細については、こちらをご覧ください）。

スコープ
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube

パラメータ

下記の表は、このクエリでサポートされているパラメータの一覧です。このリストのパラメータはすべてクエリ パラメータです。

パラメータ
必須パラメータ
part	string この操作では、part パラメータは 2 つの目的で使用されます。書き込み操作で設定されるプロパティの特定と API レスポンスに含まれるプロパティの特定です。 このパラメータに指定できる part 名は snippet、contentDetails、status です。

リクエストの本文

リクエストの本文には playlistItem リソースを指定します。 このリソースでは、次の点に注意してください。

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

  • snippet.playlistId
  • snippet.resourceId

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

  • snippet.playlistId
  • snippet.position
  • snippet.resourceId
  • contentDetails.note
  • contentDetails.startAt
  • contentDetails.endAt

レスポンス

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

エラー

次の表は、このメソッドを呼び出したときに API からレスポンスとして返される可能性のあるエラー メッセージの一覧です。詳細については、エラー メッセージのドキュメントを参照してください。

エラー タイプ	エラーの詳細	説明
duplicate	videoAlreadyInPlaylist	再生リストに追加しようとしている動画は既に再生リストに登録されています。
forbidden	playlistContainsMaximumNumberOfVideos	再生リスト内のアイテム数は、既に許容されている最大数に達しています。
invalidValue	invalidPlaylistItemPosition	このリクエストは、再生リスト アイテムの位置に無効な値またはサポートされていない値を設定しようとしています。リソースの snippet で position プロパティの値を確認してください。
invalidValue	invalidResourceType	リソース ID に指定された type は、この操作ではサポートされていません。リソース ID は、再生リストに追加するアイテムを特定します（例: youtube#video）。
notFound	playlistNotFound	リクエストの playlistId パラメータで特定される再生リストが見つかりません。
notFound	videoNotFound	再生リストに追加しようとしている動画は見つかりません。videoId プロパティの値が正しいことを確認してください。
required	channelIdRequired	必須プロパティ channelId の値がリクエストに指定されていません。
required	playlistIdRequired	必須プロパティ playlistId の値がリクエストに指定されていません。
required	resourceIdRequired	このリクエストには、snippet オブジェクトで resourceId として指定されているリソースが含まれていなければなりません。

実際に試してみる

API Explorer を使用し、ライブ データに対してこのメソッドを呼び出して、API リクエストとレスポンスを確認してください。