Method: users.settings.delegates.create

Eine bevollmächtigte Person wird hinzugefügt, deren Bestätigungsstatus direkt auf accepted festgelegt ist, ohne dass eine Bestätigungs-E-Mail gesendet wird. Der delegierte Nutzer muss Mitglied derselben Google Workspace-Organisation wie der delegierende Nutzer sein.

In Gmail gibt es Beschränkungen für die Anzahl der Bevollmächtigten und Delegierten, die jeder Nutzer in einer Google Workspace-Organisation haben kann. Diese Beschränkungen hängen von Ihrer Organisation ab, aber in der Regel kann jeder Nutzer bis zu 25 und bis zu 10 Delegierte haben.

Beachten Sie, dass ein Bevollmächtigter mit seiner primären E-Mail-Adresse und nicht mit einem E-Mail-Alias angeschrieben werden muss.

Wenn ein neuer Bevollmächtigter erstellt wird, kann es bis zu eine Minute dauern, bis er verfügbar ist.

Diese Methode ist nur für Dienstkontoclients verfügbar, denen domainweite Befugnisse 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.