PlaylistItems: delete

再生リストのアイテムを削除します。 今すぐ試す

リクエスト

HTTP リクエスト

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

承認

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

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

パラメータ

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

パラメータ
必須パラメータ
id string
id パラメータには、削除する再生リスト アイテムの YouTube 再生リスト アイテム ID を指定します。playlistItem リソースの場合、id プロパティには再生リスト アイテムの ID を指定します。

リクエストの本文

このメソッドを呼び出す場合は、リクエストの本文を指定しないでください。

レスポンス

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

エラー

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

エラー タイプ エラーの詳細 説明
forbidden playlistItemsNotAccessible リクエストは適切に認証されていないため、指定された再生リスト アイテムを削除できません。
notFound playlistItemNotFound リクエストの id パラメータで特定される再生リスト アイテムが見つかりません。

実際に試してみる

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