Method: users.settings.delegates.create
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Thêm người được uỷ quyền với trạng thái xác minh được đặt trực tiếp thành accepted mà không cần gửi email xác minh nào. Người dùng được uỷ quyền phải là thành viên của cùng một tổ chức Google Workspace với người uỷ quyền.
Gmail áp dụng các giới hạn về số lượng người được uỷ quyền và người uỷ quyền mà mỗi người dùng trong một tổ chức Google Workspace có thể có. Các giới hạn này tuỳ thuộc vào tổ chức của bạn, nhưng nhìn chung, mỗi người dùng có thể có tối đa 25 người được uỷ quyền và tối đa 10 người uỷ quyền.
Xin lưu ý rằng người dùng được uỷ quyền phải được tham chiếu bằng địa chỉ email chính của họ, chứ không phải bằng email đại diện.
Ngoài ra, xin lưu ý rằng khi tạo một người được uỷ quyền mới, có thể mất tới một phút thì người được uỷ quyền mới mới có thể sử dụng được.
Phương thức này chỉ dành cho các ứng dụng tài khoản dịch vụ đã được uỷ quyền quyền trên toàn miền.
Yêu cầu HTTP
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Thông số |
userId |
string
Địa chỉ email của người dùng. Bạn có thể sử dụng giá trị đặc biệt "tôi" để chỉ báo người dùng đã xác thực.
|
Nội dung yêu cầu
Nội dung yêu cầu chứa một bản sao của Delegate.
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một thực thể Delegate mới tạo.
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/gmail.settings.sharing
Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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)."]]
