Method: users.settings.delegates.delete
Entfernt den angegebenen Bevollmächtigten, der einen beliebigen Bestätigungsstatus haben kann, und hebt alle Bestätigungen auf, die möglicherweise für seine Verwendung erforderlich waren.
Beachten Sie, dass ein Bevollmächtigter mit seiner primären E-Mail-Adresse und nicht mit einem E-Mail-Alias angeschrieben werden muss.
Diese Methode ist nur für Dienstkontoclients verfügbar, denen domainweite Befugnisse delegiert wurden.
HTTP-Anfrage
DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates/{delegateEmail}
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.
|
delegateEmail |
string
Die E-Mail-Adresse des Nutzers, der als Bevollmächtigter entfernt werden soll.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.
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: 2024-09-05 (UTC).
[null,null,["Zuletzt aktualisiert: 2024-09-05 (UTC)."],[[["Removes a delegate user identified by their primary email address, revoking any associated verification."],["This action is restricted to service account clients with delegated domain-wide authority."],["The request must specify the user and delegate's email addresses as path parameters."],["A successful operation results in an empty response body, indicating the delegate was removed."],["This functionality requires the `https://www.googleapis.com/auth/gmail.settings.sharing` OAuth scope for authorization."]]],["This outlines how to remove a delegate from a user's Gmail account. A `DELETE` HTTP request is sent to a specific URL, including the user's email (`userId`) and the delegate's email (`delegateEmail`) as path parameters. The request body must be empty. A successful removal returns an empty response body. This operation is only available to service accounts with domain-wide authority, and it requires the `gmail.settings.sharing` authorization scope. Only primary email address can be used for the delegate.\n"]]
