Method: users.labels.list
Liệt kê tất cả các nhãn trong hộp thư của người dùng.
Yêu cầu HTTP
GET https://gmail.googleapis.com/gmail/v1/users/{userId}/labels
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 me có thể dùng để cho biết người dùng đã được 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ế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 |
{
"labels": [
{
object (Label )
}
]
} |
Trường |
labels[] |
object (Label )
Danh sách nhãn. Lưu ý rằng mỗi tài nguyên nhãn chỉ chứa một id , name , messageListVisibility , labelListVisibility và type . Phương thức labels.get có thể tìm nạp thông tin chi tiết bổ sung về nhãn.
|
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau:
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.readonly
https://www.googleapis.com/auth/gmail.labels
https://www.googleapis.com/auth/gmail.metadata
Để 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 all labels, such as \"Inbox\" or \"Starred\", in a user's Gmail mailbox."],["Sends an HTTP GET request to the Gmail API with the user's ID to retrieve the labels."],["Returns a JSON response containing an array of labels with basic information like ID, name, and visibility."],["Requires authorization with specific Gmail scopes, such as `https://mail.google.com/` or `https://www.googleapis.com/auth/gmail.readonly`, to access the user's mailbox."]]],[]]