Subscriptions: delete

サブスクリプションを削除します。

割り当てへの影響: このメソッドの呼び出しにより、50 ユニットの割り当てコストが発生します。

一般的なユースケース

リクエスト

HTTP リクエスト

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

認可

このリクエストは、少なくとも次のうち 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 を指定します。subscription リソースでは、id プロパティに YouTube サブスクリプション ID を指定します。

リクエスト本文

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

レスポンス

成功すると、このメソッドは HTTP 204 レスポンス コード(No Content)を返します。

エラー

次の表に、このメソッドの呼び出しに対して API から返されるエラー メッセージを示します。詳細については、エラー メッセージのドキュメントを参照してください。

エラーのタイプ エラーの詳細 説明
forbidden (403) subscriptionForbidden リクエストが適切に認証されていないか、このチャンネルではサポートされていません。
notFound (404) subscriptionNotFound 削除しようとしているチャンネル登録が見つかりません。リクエストの id パラメータの値が正しいことを確認してください。

試してみよう:

APIs Explorer を使用してこの API を呼び出し、API のリクエストとレスポンスを確認します。