Method: users.settings.delegates.list

Listet die Bevollmächtigten für das angegebene Konto auf.

Diese Methode ist nur für Dienstkonto-Clients verfügbar, denen domainweite Berechtigungen übertragen 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. Mit dem speziellen Wert „me“ kann der authentifizierte Nutzer angegeben werden.

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 Stellvertreter des Nutzers (mit beliebigem Bestätigungsstatus). Wenn ein Konto keine Stellvertreter 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 unter OAuth 2.0 Overview.