REST Resource: users.settings.delegates
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Resource: Delegate
Setelan untuk delegasi. Penerima delegasi dapat membaca, mengirim, dan menghapus pesan, serta melihat dan menambahkan kontak, untuk akun pemberi delegasi. Lihat "Menyiapkan delegasi email" untuk mengetahui informasi selengkapnya tentang delegasi.
| Representasi JSON |
{
"delegateEmail": string,
"verificationStatus": enum (VerificationStatus)
} |
| Kolom |
delegateEmail |
string
Alamat email delegasi.
|
verificationStatus |
enum (VerificationStatus)
Menunjukkan apakah alamat ini telah diverifikasi dan dapat bertindak sebagai delegasi untuk akun. Hanya baca.
|
VerificationStatus
Menunjukkan apakah kepemilikan alamat email telah diverifikasi untuk penggunaan delegasi.
| Enum |
verificationStatusUnspecified |
Status verifikasi tidak ditentukan. |
accepted |
Alamat tersebut dapat bertindak sebagai penerima delegasi untuk akun. |
pending |
Permintaan verifikasi telah dikirim melalui pos ke alamat tersebut, dan pemiliknya belum menerimanya. |
rejected |
Permintaan verifikasi telah dikirim melalui pos ke alamat tersebut, dan pemiliknya menolaknya. |
expired |
Permintaan verifikasi dikirim melalui pos ke alamat tersebut, dan masa berlakunya habis tanpa verifikasi. |
Metode |
|
|
Menambahkan delegasi dengan status verifikasi yang ditetapkan langsung ke accepted, tanpa mengirim email verifikasi apa pun. |
|
|
Menghapus delegasi yang ditentukan (yang dapat memiliki status verifikasi apa pun), dan mencabut verifikasi apa pun yang mungkin diperlukan untuk menggunakannya. |
|
|
Mendapatkan delegasi yang ditentukan. |
|
|
Mencantumkan penerima delegasi untuk akun yang ditentukan. |
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-25 UTC.
[null,null,["Terakhir diperbarui pada 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. |"]]
