Method: users.settings.delegates.create

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

In Gmail gibt es Einschränkungen für die Anzahl der delegierten und delegierenden Nutzer in einer Google Workspace-Organisation. Diese Limits hängen von Ihrer Organisation ab. Im Allgemeinen kann jeder Nutzer jedoch bis zu 25 Delegierte und bis zu 10 Delegierende haben.

Hinweis: Ein delegierter Nutzer muss über seine primäre E-Mail-Adresse und nicht über einen E-Mail-Alias angesprochen werden.

Beachten Sie außerdem, dass es nach dem Erstellen eines neuen Bevollmächtigten bis zu einer Minute dauern kann, bis er verwendet werden kann.

Diese Methode ist nur für Dienstkonto-Clients verfügbar, denen domainweite Berechtigungen delegiert 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

Bei Erfolg 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 im Leitfaden zur Autorisierung.