REST Resource: users.settings.delegates
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
리소스: Delegate
위임받은 사용자의 설정입니다. 위임받은 사용자는 위임자의 계정에서 메일을 읽고 보내고 삭제할 수 있으며 연락처를 확인하고 추가할 수도 있습니다. 위임에 관한 자세한 내용은 '메일 위임 설정'을 참고하세요.
필드 |
delegateEmail |
string
대리인의 이메일 주소입니다.
|
verificationStatus |
enum (VerificationStatus )
이 주소가 인증되었으며 계정의 위임자 역할을 할 수 있는지 여부를 나타냅니다. 읽기 전용입니다.
|
VerificationStatus
위임 사용을 위해 이메일 주소의 소유권이 확인되었는지 여부를 나타냅니다.
열거형 |
verificationStatusUnspecified |
지정되지 않은 인증 상태입니다. |
accepted |
이 주소는 계정의 위임자 역할을 할 수 있습니다. |
pending |
주소로 인증 요청을 우편으로 보냈으나 소유자가 아직 수락하지 않았습니다. |
rejected |
주소로 인증 요청을 우편으로 보냈으나 소유자가 거부했습니다. |
expired |
주소로 인증 요청이 우편으로 전송되었으나 인증 없이 만료되었습니다. |
메서드 |
|
확인 이메일을 보내지 않고 확인 상태가 accepted 로 직접 설정된 위임을 추가합니다. |
|
지정된 위임을 삭제하고 (위임은 인증 상태와 관계없음) 이를 사용하는 데 필요했을 수 있는 인증을 취소합니다. |
|
지정된 대리자를 가져옵니다. |
|
지정된 계정의 위임자를 나열합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 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. |"]]