Method: users.settings.delegates.create

Fügt einen Bevollmächtigten hinzu, dessen Bestätigungsstatus direkt auf accepted gesetzt wird, ohne dass eine Bestätigungs-E-Mail gesendet wird. Der Bevollmächtigte muss Mitglied derselben Google Workspace-Organisation wie der Bevollmächtigende sein.

In Gmail gelten Beschränkungen für die Anzahl der Delegierten und Delegierenden, die jeder Nutzer in einer Google Workspace-Organisation haben kann. Diese Beschränkungen hängen von Ihrer Organisation ab. Im Allgemeinen kann jeder Nutzer bis zu 25 Bevollmächtigte und bis zu 10 Bevollmächtigende haben.

Ein delegierter Nutzer muss mit seiner primären E-Mail-Adresse und nicht mit einem E-Mail-Alias angegeben werden.

Wenn ein neuer Bevollmächtigter erstellt wird, kann es bis zu einer Minute dauern, bis er verwendet werden kann.

Diese Methode ist nur für Dienstkonto-Clients verfügbar, denen domainweite Berechtigungen übertragen wurden.

HTTP-Anfrage

POST 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 enthält eine Instanz von Delegate.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine neu erstellte Instanz von Delegate.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/gmail.settings.sharing

Weitere Informationen finden Sie unter OAuth 2.0 Overview.