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.