REST Resource: users.settings.delegates
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Zasób: Delegate
Ustawienia dla osoby, która ma dostęp do Twojego konta. Przedstawiciele mogą czytać, wysyłać i usuwać wiadomości, a także wyświetlać i dodawać kontakty na koncie właściciela. Więcej informacji o przekazywaniu dostępu do poczty znajdziesz w artykule Konfigurowanie przekazywania dostępu do poczty.
| Pola |
delegateEmail |
string
Adres e-mail osoby z przekazanym dostępem.
|
verificationStatus |
enum (VerificationStatus)
Wskazuje, czy ten adres został zweryfikowany i czy może działać jako konto zastępcze. Tylko do odczytu.
|
VerificationStatus
Wskazuje, czy własność adresu e-mail została zweryfikowana na potrzeby delegowania.
| Wartości w polu enum |
verificationStatusUnspecified |
Nieokreślony stan weryfikacji. |
accepted |
Adres może działać jako przedstawiciel konta. |
pending |
Na adres została wysłana prośba o weryfikację, ale właściciel nie zaakceptował jej jeszcze. |
rejected |
Na adres został wysłany e-mail z prośbą o weryfikację, ale właściciel odrzucił ją. |
expired |
Na adres wysłano prośbę o weryfikację, która wygasła bez weryfikacji. |
Metody |
|
|
Dodaje użytkownika zweryfikowanego jako accepted bez wysyłania e-maila weryfikacyjnego. |
|
|
Usuwa określonego użytkownika (który może mieć dowolny stan weryfikacji) i odwołuje wszelkie weryfikacje, które mogły być wymagane do korzystania z tego konta. |
|
|
Pobiera wskazanego przedstawiciela. |
|
|
Wyświetla listę przedstawicieli na określonym koncie. |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 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. |"]]
