再生リストのアイテムを削除します。
割り当ての影響:このメソッドを呼び出すと、割り当てコストは 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 |
string id パラメータには、削除する再生リスト アイテムの 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 のリクエストとレスポンスを確認します。