Method: subscriptions.delete
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Richiesta HTTP
DELETE https://workspaceevents.googleapis.com/v1beta/{name=subscriptions/*}
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri |
name |
string
Obbligatorio. Nome della risorsa dell'abbonamento da eliminare. Formato: subscriptions/{subscription}
|
Parametri di query
| Parametri |
validateOnly |
boolean
(Facoltativo) Se impostato su true, convalida e visualizza l'anteprima della richiesta, ma non elimina l'abbonamento.
|
allowMissing |
boolean
(Facoltativo) Se è impostato su true e l'abbonamento non viene trovato, la richiesta va a buon fine, ma l'abbonamento non viene eliminato.
|
etag |
string
(Facoltativo) ETag dell'abbonamento. Se presente, deve corrispondere all'etag del server. In caso contrario, la richiesta non va a buon fine e viene restituito lo stato ABORTED.
|
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.
- Il campo
metadata contiene un array vuoto. - Il campo
response è vuoto.
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/chat.bot
https://www.googleapis.com/auth/chat.spaces
https://www.googleapis.com/auth/chat.spaces.readonly
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/chat.messages.readonly
https://www.googleapis.com/auth/chat.messages.reactions
https://www.googleapis.com/auth/chat.messages.reactions.readonly
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.readonly
https://www.googleapis.com/auth/meetings.space.created
https://www.googleapis.com/auth/meetings.space.readonly
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.metadata
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/drive.readonly
Per ulteriori informazioni, consulta la Guida all'autorizzazione.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[[["\u003cp\u003eThis document describes how to delete a Google Workspace subscription using the \u003ccode\u003eDELETE\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires specifying the subscription name in the URL path and can optionally include query parameters for validation, error handling, and Etag verification.\u003c/p\u003e\n"],["\u003cp\u003eAn empty request body is required, and a successful response will return an Operation object indicating the deletion process.\u003c/p\u003e\n"],["\u003cp\u003eTo authorize this request, you need one of the listed OAuth scopes, such as \u003ccode\u003ehttps://www.googleapis.com/auth/chat.bot\u003c/code\u003e or those related to Chat, Meetings, and Spaces.\u003c/p\u003e\n"],["\u003cp\u003eThis feature is part of the Google Workspace Developer Preview Program and may be subject to change.\u003c/p\u003e\n"]]],["This document outlines the process for deleting a Google Workspace subscription via an HTTP DELETE request to `https://workspaceevents.googleapis.com/v1beta/{name=subscriptions/*}`. The `name` path parameter is required to specify the subscription. Optional query parameters include `validateOnly`, `allowMissing`, and `etag`. The request body should be empty. A successful operation returns an Operation instance, while specific OAuth scopes are required for authorization.\n"],null,["# Method: subscriptions.delete\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\n| **Developer Preview:** Available as part of the [Google Workspace Developer Preview Program](/workspace/preview), which grants early access to certain features.\n\nDeletes a Google Workspace subscription. To learn how to use this method, see [Delete a Google Workspace subscription](https://developers.google.com/workspace/events/guides/delete-subscription).\n\n### HTTP request\n\n`DELETE https://workspaceevents.googleapis.com/v1beta/{name=subscriptions/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|--------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. Resource name of the subscription to delete. Format: `subscriptions/{subscription}` |\n\n### Query parameters\n\n| Parameters ||\n|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------|\n| `validateOnly` | `boolean` Optional. If set to `true`, validates and previews the request, but doesn't delete the subscription. |\n| `allowMissing` | `boolean` Optional. If set to `true` and the subscription isn't found, the request succeeds but doesn't delete the subscription. |\n| `etag` | `string` Optional. Etag of the subscription. If present, it must match with the server's etag. Otherwise, request fails with the status `ABORTED`. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/workspace/events/reference/rest/v1beta/operations#Operation).\n\n- The `metadata` field contains an empty array.\n- The `response` field is empty.\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/chat.bot`\n- `\n https://www.googleapis.com/auth/chat.spaces`\n- `\n https://www.googleapis.com/auth/chat.spaces.readonly`\n- `\n https://www.googleapis.com/auth/chat.messages`\n- `\n https://www.googleapis.com/auth/chat.messages.readonly`\n- `\n https://www.googleapis.com/auth/chat.messages.reactions`\n- `\n https://www.googleapis.com/auth/chat.messages.reactions.readonly`\n- `\n https://www.googleapis.com/auth/chat.memberships`\n- `\n https://www.googleapis.com/auth/chat.memberships.readonly`\n- `\n https://www.googleapis.com/auth/meetings.space.created`\n- `\n https://www.googleapis.com/auth/meetings.space.readonly`\n- `\n https://www.googleapis.com/auth/drive`\n- `\n https://www.googleapis.com/auth/drive.file`\n- `\n https://www.googleapis.com/auth/drive.metadata`\n- `\n https://www.googleapis.com/auth/drive.metadata.readonly`\n- `\n https://www.googleapis.com/auth/drive.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
