Method: users.settings.forwardingAddresses.delete
Die angegebene Weiterleitungsadresse wird gelöscht und alle erforderlichen Bestätigungen werden widerrufen.
Diese Methode ist nur für Dienstkonto-Clients verfügbar, denen domainweite Berechtigungen delegiert wurden.
HTTP-Anfrage
DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/forwardingAddresses/{forwardingEmail}
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
userId |
string
E-Mail-Adresse des Nutzers. Mit dem speziellen Wert „me“ kann der authentifizierte Nutzer angegeben werden.
|
forwardingEmail |
string
Die zu löschende Weiterleitungsadresse.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, ist der Antworttext ein leeres JSON-Objekt.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/gmail.settings.sharing
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-03-14 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-03-14 (UTC)."],[[["Deletes a specified forwarding address and any associated verification for service account clients with domain-wide authority."],["Requires a `DELETE` request to the Gmail API with the user ID and forwarding email address in the path."],["Request body should be empty, and a successful deletion results in an empty response body."],["Needs authorization with the `https://www.googleapis.com/auth/gmail.settings.sharing` OAuth scope."]]],["This document outlines the process to delete a forwarding address in Gmail using a `DELETE` HTTP request. The request requires a `userId` and `forwardingEmail` in the URL path. The request body must be empty. Successful deletion yields an empty response body. This action is restricted to service accounts with delegated domain-wide authority. It needs `https://www.googleapis.com/auth/gmail.settings.sharing` OAuth scope for authorization. gRPC Transcoding syntax is utilized in the URL.\n"]]
