Videos: delete

YouTube 動画を削除します。今すぐ試す。

リクエスト

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

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

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

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

パラメータ
必須パラメータ
`id`	`string` `id` パラメータには、削除するリソースの YouTube 動画 ID を指定します。`video` リソースの場合、`id` プロパティには動画の ID を指定します。
省略可能なパラメータ
`onBehalfOfContentOwner`	`string` このパラメータは、適切に承認されたリクエストでのみ使用できます。注: このパラメータは、YouTube コンテンツパートナー専用です。 `onBehalfOfContentOwner` パラメータは、リクエストの承認用認証情報が、パラメータ値で指定されたコンテンツ所有者の代理人である YouTube CMS ユーザーのものであることを示します。このパラメータは、複数の YouTube チャンネルを所有、管理している YouTube コンテンツパートナーを対象にしています。このパラメータを使用すると、コンテンツ所有者は一度認証されれば、すべての動画やチャンネルデータにアクセスできるようになります。チャンネルごとに認証情報を指定する必要はありません。ユーザー認証に使用する実際の CMS アカウントは、指定された YouTube コンテンツ所有者にリンクされていなければなりません。

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

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

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

エラータイプ	エラーの詳細	説明
`forbidden`	`forbidden`	動画を削除しようとしていますが、削除できません。リクエストが適切に認証されていない可能性があります。
`notFound`	`videoNotFound`	削除しようとしている動画は見つかりません。リクエストの `id` パラメータの値が正しいことを確認してください。

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