再生リストのアイテムを削除します。
割り当てへの影響: このメソッドの呼び出しには 50 ユニットの割り当てコストがかかります。
一般的なユースケース
リクエスト
HTTP リクエスト
DELETE https://www.googleapis.com/youtube/v3/playlistItems
承認
このリクエストには、次のスコープのいずれか 1 つ以上の承認が必要です。認証と認可の詳細については、OAuth 2.0 認可の実装をご覧ください。
| スコープ |
|---|
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 コンテンツ パートナー向けに設計されています。コンテンツ所有者に関連付けられたユーザーは、1 回認証するだけで、個々のチャンネルの認証情報を提供することなく、コンテンツ所有者のすべての動画とチャンネルのデータにアクセスして管理できます。 このパラメータが存在する場合、その値はコンテンツ所有者を識別し、リクエストの認証情報は、そのコンテンツ所有者の代理として行動することを認可された YouTube ユーザーを識別します。ユーザーが認証に使用するアカウントは、YouTube クリエイター スタジオの設定で指定されたコンテンツ所有者にリンクされている必要があります。 |
|
リクエストの本文
このメソッドを呼び出す場合は、リクエストの本文を指定しないでください。
レスポンス
成功した場合、このメソッドは HTTP 204 No Content ステータス コードを返します。
エラー
次の表に、このメソッドの呼び出しに応じて API が返す可能性があるエラー メッセージを示します。詳細については、YouTube Data API - エラーをご覧ください。
| エラーのタイプ | エラーの詳細 | 説明 |
|---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
リクエストは適切に認証されていないため、指定された再生リスト アイテムを削除できません。 |
notFound (404) |
playlistItemNotFound |
リクエストの id パラメータで識別された再生リスト アイテムが見つかりません。 |
invalidValue (400) |
playlistOperationUnsupported |
この API では、指定した再生リストから動画を削除する機能はサポートされていません。たとえば、アップロードした動画の再生リストから動画を削除することはできません。 |
試してみよう:
APIs Explorer を使用してこの API を呼び出し、API リクエストとレスポンスを確認します。