Method: users.settings.delegates.list

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

Diese Methode ist nur für Dienstkontoclients verfügbar, die domainweit autorisiert 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 delegates.list-Methode.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "delegates": [
    {
      object (Delegate)
    }
  ]
}
Felder
delegates[]

object (Delegate)

Liste der Nutzer (mit jeglichem 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.