Deletes a subscription. Try it now.
Quota impact: A call to this method has a quota cost of approximately 50 units.
Request
HTTP request
DELETE https://www.googleapis.com/youtube/v3/subscriptions
Authorization
This request requires authorization with at least one of the following scopes (read more about authentication and authorization).
| Scope |
|---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
Parameters
The table below lists the parameters that this query supports. All of the parameters listed are query parameters.
| Parameter name | Value | Description |
|---|---|---|
| Required parameters | ||
id |
string |
The id parameter specifies the YouTube subscription ID for the resource that is being deleted. In a subscription resource, the id property specifies the YouTube subscription ID. |
Request body
Do not provide a request body when calling this method.
Response
If successful, this method returns a subscription resource in the response body.
Errors
The table below identifies error messages that the API could return in response to a call to this method. Please see the error message documentation for more detail.
| Error type | Error detail | Description |
|---|---|---|
badRequest (400) |
accountClosed |
The account attempting to create the subscription has been closed. |
badRequest (400) |
accountSuspended |
The account attempting to create the subscription has been suspended. |
forbidden (403) |
subscriptionForbidden |
The request is not properly authenticated or not supported for this channel. |
notFound (404) |
subscriptionNotFound |
The subscription that you are trying to delete cannot be found. Check the value of the request's id parameter to ensure that it is correct. |
Try it!
Use the API Explorer to call this method on live data and see the API request and response.