Method: users.settings.delegates.create
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Menambahkan delegasi dengan status verifikasi yang ditetapkan langsung ke accepted, tanpa mengirim email verifikasi apa pun. Pengguna penerima delegasi harus merupakan anggota organisasi Google Workspace yang sama dengan pengguna pemberi delegasi.
Gmail memberlakukan batasan jumlah delegasi dan delegator yang dapat dimiliki setiap pengguna di organisasi Google Workspace. Batas ini bergantung pada organisasi Anda, tetapi secara umum setiap pengguna dapat memiliki maksimal 25 penerima delegasi dan maksimal 10 pemberi delegasi.
Perhatikan bahwa pengguna penerima delegasi harus dirujuk dengan alamat email primernya, bukan alias email.
Perhatikan juga bahwa saat delegasi baru dibuat, mungkin ada penundaan hingga satu menit sebelum delegasi baru tersedia untuk digunakan.
Metode ini hanya tersedia untuk klien akun layanan yang telah didelegasikan otorisasi tingkat domain.
Permintaan HTTP
POST 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 memuat instance Delegate.
Isi respons
Jika berhasil, isi respons memuat instance Delegate yang baru dibuat.
Cakupan otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/gmail.settings.sharing
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.create\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- [Authorization scopes](#body.aspect)\n\nAdds a delegate with its verification status set directly to `accepted`, without sending any verification email. The delegate user must be a member of the same Google Workspace organization as the delegator user.\n\nGmail imposes limitations on the number of delegates and delegators each user in a Google Workspace organization can have. These limits depend on your organization, but in general each user can have up to 25 delegates and up to 10 delegators.\n\nNote that a delegate user must be referred to by their primary email address, and not an email alias.\n\nAlso note that when a new delegate is created, there may be up to a one minute delay before the new delegate is available for use.\n\nThis method is only available to service account clients that have been delegated domain-wide authority.\n\n### HTTP request\n\n`POST 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 contains an instance of [Delegate](/workspace/gmail/api/reference/rest/v1/users.settings.delegates#Delegate).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Delegate](/workspace/gmail/api/reference/rest/v1/users.settings.delegates#Delegate).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/gmail.settings.sharing`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
