Method: users.settings.delegates.list
Liệt kê những người được uỷ quyền cho tài khoản đã chỉ định.
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 trên toàn miền.
Yêu cầu HTTP
GET 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
Tham số |
userId |
string
Địa chỉ email của người dùng. Giá trị đặc biệt "tôi" có thể được sử dụng để chỉ rõ người dùng đã xác thực.
|
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Nội dung phản hồi cho phương thức đại diện.list.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
{
"delegates": [
{
object (Delegate )
}
]
} |
Trường |
delegates[] |
object (Delegate )
Danh sách người được uỷ quyền của người dùng (có trạng thái xác minh bất kỳ). Nếu một tài khoản không có người được uỷ quyền, thì trường này sẽ không xuất hiện.
|
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau:
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
Để 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: 2024-09-05 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2024-09-05 UTC."],[[["Lists delegates for a specified account, accessible only to service accounts with domain-wide authority."],["Employs a `GET` request to the endpoint `https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates`, using gRPC Transcoding syntax."],["Requires an empty request body and returns a JSON response containing a list of delegates, if any."],["Needs authorization with specific OAuth scopes like `https://www.googleapis.com/auth/gmail.settings.basic` or `https://www.googleapis.com/auth/gmail.modify`."]]],["A `GET` request is made to `https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates` to list an account's delegates. The `userId` path parameter, which can be \"me,\" specifies the user. The request body must be empty. The response body, if successful, includes a JSON structure with a list of delegate objects under the \"delegates\" field. This action requires service account clients with domain-wide authority and specific OAuth scopes.\n"]]