Subscriptions: delete

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

登録チャンネルを削除します。 今すぐ試す

リクエスト

HTTP リクエスト

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

承認

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

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

パラメータ

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

パラメータ
必須パラメータ
id string
id パラメータには、削除するリソースの YouTube 登録チャンネル ID を指定します。subscription リソースの場合、id プロパティには YouTube 登録チャンネル ID を指定します。

リクエストの本文

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

レスポンス

成功すると、このメソッドはレスポンスの本文で登録チャンネル リソースを返します。

エラー

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

エラー タイプ エラーの詳細 説明
badRequest accountClosed チャンネル登録を作成しようとしているアカウントは閉じられています。
badRequest accountSuspended チャンネル登録を作成しようとしているアカウントは一時停止されています。
forbidden subscriptionForbidden リクエストが適切に認証されていないか、このチャンネルではサポートされていません。
notFound subscriptionNotFound 削除しようとしているチャンネル登録が見つかりません。リクエストの id パラメータの値が正しいことを確認してください。

実際に試してみる

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