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 名は snippetcontentDetailsstatus です。

リクエストの本文

リクエストの本文には 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 このリクエストは、再生リスト アイテムの位置に無効な値またはサポートされていない値を設定しようとしています。リソースの snippetposition プロパティの値を確認してください。
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 リクエストとレスポンスを確認してください。