Method: users.settings.delegates.list
Listet die Bevollmächtigten für das angegebene Konto auf.
Diese Methode ist nur für Dienstkontoclients verfügbar, denen domainweite Berechtigungen zugewiesen wurden.
HTTP-Anfrage
GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
userId |
string
E-Mail-Adresse des Nutzers. Der spezielle Wert „me“ kann verwendet werden, um den authentifizierten Nutzer anzugeben.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwort für die Methode "delegates.list".
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"delegates": [
{
object (Delegate)
}
]
} |
| Felder |
delegates[] |
object (Delegate)
Liste der Bevollmächtigten des Nutzers (mit unabhängigem Bestätigungsstatus). Wenn ein Konto keine Bevollmächtigten hat, wird dieses Feld nicht angezeigt.
|
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/gmail.settings.basic
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.readonly
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)."],[[["Lists delegates for a specified account, accessible only to service accounts with domain-wide authority."],["Employs a `GET` request to the endpoint `https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates`, using gRPC Transcoding syntax."],["Requires an empty request body and returns a JSON response containing a list of delegates, if any."],["Needs authorization with specific OAuth scopes like `https://www.googleapis.com/auth/gmail.settings.basic` or `https://www.googleapis.com/auth/gmail.modify`."]]],["A `GET` request is made to `https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates` to list an account's delegates. The `userId` path parameter, which can be \"me,\" specifies the user. The request body must be empty. The response body, if successful, includes a JSON structure with a list of delegate objects under the \"delegates\" field. This action requires service account clients with domain-wide authority and specific OAuth scopes.\n"]]
