再生リストのアイテムを削除します。
割り当てへの影響: このメソッドの呼び出しにより、50 ユニットの割り当てコストが発生します。
一般的なユースケース
リクエスト
HTTP リクエスト
DELETE https://www.googleapis.com/youtube/v3/playlistItems
認可
このリクエストは、少なくとも次のうち 1 つのスコープでの承認が必要です（認証と承認の詳細をご確認ください）。
| 範囲 |
|---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
パラメータ
次の表に、このクエリでサポートされているパラメータを示します。このリストのパラメータはすべてクエリ パラメータです。
| パラメータ | ||
|---|---|---|
| 必須パラメータ | ||
id |
stringid パラメータには、削除する再生リスト アイテムの YouTube 再生リストのアイテム ID を指定します。playlistItem リソースでは、id プロパティに再生リスト アイテムの ID を指定します。 |
|
| オプション パラメータ | ||
onBehalfOfContentOwner |
string注: onBehalfOfContentOwner パラメータは YouTube コンテンツ パートナー専用で、適切に承認されたリクエストでのみ使用できます。このパラメータは、さまざまな YouTube チャンネルを所有および管理している YouTube コンテンツ パートナー向けに設計されています。コンテンツ所有者に所属するユーザーは、一度認証すれば、チャンネルごとに認証情報を提示しなくても、コンテンツ所有者の動画およびチャンネルのすべてのデータにアクセスして管理できるようになります。 このパラメータが存在する場合、その値はコンテンツ所有者を識別し、リクエストの承認認証情報はそのコンテンツ所有者の代理権限がある YouTube ユーザーを識別します。ユーザーが認証に使用するアカウントは、YouTube クリエイター ツールの設定で指定したコンテンツ所有者にリンクされている必要があります。 |
|
リクエスト本文
このメソッドを呼び出す場合は、リクエストの本文を指定しないでください。
レスポンス
成功すると、このメソッドは HTTP 204 レスポンス コード（No Content）を返します。
エラー
次の表に、このメソッドの呼び出しに対して API から返されるエラー メッセージを示します。詳細については、エラー メッセージのドキュメントを参照してください。
| エラーのタイプ | エラーの詳細 | 説明 |
|---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
リクエストは適切に認証されていないため、指定された再生リスト アイテムを削除できません。 |
notFound (404) |
playlistItemNotFound |
リクエストの id パラメータで識別される再生リストのアイテムが見つかりません。 |
invalidValue (400) |
playlistOperationUnsupported |
この API では、指定した再生リストから動画を削除する機能はサポートされていません。たとえば、アップロードした動画の再生リストから動画を削除することはできません。 |
試してみよう:
APIs Explorer を使用してこの API を呼び出し、API のリクエストとレスポンスを確認します。