Method: users.settings.delegates.list
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Mencantumkan penerima delegasi untuk akun yang ditentukan.
Metode ini hanya tersedia untuk klien akun layanan yang telah didelegasikan otorisasi tingkat domain.
Permintaan HTTP
GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
| Parameter |
userId |
string
Alamat email pengguna. Nilai khusus "me" dapat digunakan untuk menunjukkan pengguna yang diautentikasi.
|
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Respons untuk metode delegates.list.
Jika berhasil, isi respons memuat data dengan struktur berikut:
| Representasi JSON |
{
"delegates": [
{
object (Delegate)
}
]
} |
| Kolom |
delegates[] |
object (Delegate)
Daftar delegasi pengguna (dengan status verifikasi apa pun). Jika akun tidak memiliki delegasi, kolom ini tidak akan muncul.
|
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/gmail.settings.basic
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.readonly
Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.
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,["# Method: users.settings.delegates.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListDelegatesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nLists the delegates for the specified account.\n\nThis method is only available to service account clients that have been delegated domain-wide authority.\n\n### HTTP request\n\n`GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------------------------|\n| `userId` | `string` User's email address. The special value \"me\" can be used to indicate the authenticated user. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse for the delegates.list method.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------|\n| ``` { \"delegates\": [ { object (/workspace/gmail/api/reference/rest/v1/users.settings.delegates#Delegate) } ] } ``` |\n\n| Fields ||\n|---------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `delegates[]` | `object (`[Delegate](/workspace/gmail/api/reference/rest/v1/users.settings.delegates#Delegate)`)` List of the user's delegates (with any verification status). If an account doesn't have delegates, this field doesn't appear. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/gmail.settings.basic`\n- `\n https://mail.google.com/`\n- `\n https://www.googleapis.com/auth/gmail.modify`\n- `\n https://www.googleapis.com/auth/gmail.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
