REST Resource: users.settings.delegates
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ressource: Bevollmächtigter
Einstellungen für einen Bevollmächtigten. Bevollmächtigte können Nachrichten für das Konto des Delegierenden lesen, senden und löschen sowie Kontakte ansehen und hinzufügen. Weitere Informationen zu Bevollmächtigten finden Sie unter E-Mail-Delegierung einrichten.
| JSON-Darstellung |
{
"delegateEmail": string,
"verificationStatus": enum (VerificationStatus)
} |
| Felder |
delegateEmail |
string
Die E-Mail-Adresse des Bevollmächtigten.
|
verificationStatus |
enum (VerificationStatus)
Gibt an, ob diese Adresse bestätigt wurde und als Bevollmächtigter für das Konto fungieren kann. Schreibgeschützt.
|
VerificationStatus
Gibt an, ob die Inhaberschaft einer E-Mail-Adresse für die delegierte Nutzung bestätigt wurde.
| Enums |
verificationStatusUnspecified |
Nicht angegebener Bestätigungsstatus. |
accepted |
Die Adresse kann als Bevollmächtigter für das Konto fungieren. |
pending |
Eine Bestätigungsanfrage wurde an die Adresse gesendet, aber der Inhaber hat sie noch nicht akzeptiert. |
rejected |
Eine Bestätigungsanfrage wurde an die Adresse gesendet und vom Eigentümer abgelehnt. |
expired |
Eine Bestätigungsanfrage wurde an die Adresse gesendet und ist ohne Bestätigung abgelaufen. |
Methoden |
|
|
Fügen Sie einen Bevollmächtigten hinzu, dessen Bestätigungsstatus direkt auf accepted gesetzt wird, ohne dass eine Bestätigungs-E-Mail gesendet wird. |
|
|
Entfernt den angegebenen Bevollmächtigten (unabhängig vom Bestätigungsstatus) und widerruft alle Bestätigungen, die für die Verwendung erforderlich waren. |
|
|
Ruft den angegebenen Delegierten ab. |
|
|
Listet die Bevollmächtigten für das angegebene Konto auf. |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[],[],null,["# REST Resource: users.settings.delegates\n\n- [Resource: Delegate](#Delegate)\n - [JSON representation](#Delegate.SCHEMA_REPRESENTATION)\n- [VerificationStatus](#VerificationStatus)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Delegate\n------------------\n\nSettings for a delegate. Delegates can read, send, and delete messages, as well as view and add contacts, for the delegator's account. See [\"Set up mail delegation\"](https://support.google.com/mail/answer/138350) for more information about delegates.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"delegateEmail\": string, \"verificationStatus\": enum (/workspace/gmail/api/reference/rest/v1/users.settings.delegates#VerificationStatus) } ``` |\n\n| Fields ||\n|----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `delegateEmail` | `string` The email address of the delegate. |\n| `verificationStatus` | `enum (`[VerificationStatus](/workspace/gmail/api/reference/rest/v1/users.settings.delegates#VerificationStatus)`)` Indicates whether this address has been verified and can act as a delegate for the account. Read-only. |\n\nVerificationStatus\n------------------\n\nIndicates whether ownership of an email address has been verified for delegation use.\n\n| Enums ||\n|---------------------------------|------------------------------------------------------------------------------------------|\n| `verificationStatusUnspecified` | Unspecified verification status. |\n| `accepted` | The address can act a delegate for the account. |\n| `pending` | A verification request was mailed to the address, and the owner has not yet accepted it. |\n| `rejected` | A verification request was mailed to the address, and the owner rejected it. |\n| `expired` | A verification request was mailed to the address, and it expired without verification. |\n\n| Methods ------- ||\n|--------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### [create](/workspace/gmail/api/reference/rest/v1/users.settings.delegates/create) | Adds a delegate with its verification status set directly to `accepted`, without sending any verification email. |\n| ### [delete](/workspace/gmail/api/reference/rest/v1/users.settings.delegates/delete) | Removes the specified delegate (which can be of any verification status), and revokes any verification that may have been required for using it. |\n| ### [get](/workspace/gmail/api/reference/rest/v1/users.settings.delegates/get) | Gets the specified delegate. |\n| ### [list](/workspace/gmail/api/reference/rest/v1/users.settings.delegates/list) | Lists the delegates for the specified account. |"]]
