Hạn mức sử dụng
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.
Gmail API có hạn mức sử dụng, hạn chế tốc độ gọi các phương thức của API. Giới hạn được xác định theo đơn vị hạn mức , một đơn vị đo lường trừu tượng thể hiện mức sử dụng tài nguyên của Gmail. Có hai hạn mức sử dụng được áp dụng đồng thời: hạn mức sử dụng cho mỗi dự án và hạn mức sử dụng cho mỗi người dùng. Bảng sau đây trình bày chi tiết các hạn mức sử dụng này:
Loại hạn mức sử dụng
Hạn mức
Lý do vượt quá
Hạn mức yêu cầu cho mỗi dự án
1.200.000 đơn vị hạn mức mỗi phút
rateLimitExceeded
Giới hạn về tốc độ cho mỗi người dùng
15.000 đơn vị hạn mức cho mỗi người dùng mỗi phút
userRateLimitExceeded
Lưu ý: Để biết thông tin về cách xử lý lỗi vượt quá hạn mức, hãy tham khảo bài viết Giải quyết lỗi .
Hạn mức sử dụng theo phương thức
Số lượng đơn vị hạn mức mà một yêu cầu sử dụng sẽ khác nhau tuỳ thuộc vào phương thức được gọi. Bảng sau đây trình bày mức sử dụng hạn mức theo từng phương thức:
Phương thức
Đơn vị hạn mức
drafts.create
10
drafts.delete
10
drafts.get
5
drafts.list
5
drafts.send
100
drafts.update
15
getProfile
1
history.list
2
labels.create
5
labels.delete
5
labels.get
1
labels.list
1
labels.update
5
messages.attachments.get
5
messages.batchDelete
50
messages.batchModify
50
messages.delete
10
messages.get
5
messages.import
25
messages.insert
25
messages.list
5
messages.modify
5
messages.send
100
messages.trash
5
messages.untrash
5
settings.delegates.create
100
settings.delegates.delete
5
settings.delegates.get
1
settings.delegates.list
1
settings.filters.create
5
settings.filters.delete
5
settings.filters.get
1
settings.filters.list
1
settings.forwardingAddresses.create
100
settings.forwardingAddresses.delete
5
settings.forwardingAddresses.get
1
settings.forwardingAddresses.list
1
settings.getAutoForwarding
1
settings.getImap
1
settings.getPop
1
settings.getVacation
1
settings.sendAs.create
100
settings.sendAs.delete
5
settings.sendAs.get
1
settings.sendAs.list
1
settings.sendAs.update
100
settings.sendAs.verify
100
settings.updateAutoForwarding
5
settings.updateImap
5
settings.updatePop
100
settings.updateVacation
5
stop
50
threads.delete
20
threads.get
10
threads.list
10
threads.modify
10
threads.trash
10
threads.untrash
10
watch
100
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-08-29 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-29 UTC."],[],[],null,["# Usage limits\n\nThe Gmail API is subject to usage limits which restrict the rate at which\nmethods of the API can be called. Limits are defined in terms of [quota\nunits](#per-method_quota_usage), an abstract unit of measurement representing\nGmail resource usage. There are two usage limits which are applied\nsimultaneously: a per project usage limit and a per user usage limit. The\nfollowing table details these usage limits:\n\n| Usage limit type | Limit | Exceeded reason |\n|------------------------|----------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------|\n| Per project rate limit | 1,200,000 quota units per minute | [rateLimitExceeded](https://developers.google.com/workspace/gmail/api/guides/handle-errors#resolve_a_403_error_rate_limit_exceeded) |\n| Per user rate limit | 15,000 quota units per user per minute | [userRateLimitExceeded](https://developers.google.com/workspace/gmail/api/guides/handle-errors#resolve_a_403_error_user_rate_limit_exceeded) |\n\n| **Note:** For information on handling limit errors, refer to [Resolve\n| errors](/workspace/gmail/api/guides/handle-errors).\n\nPer-method quota usage\n----------------------\n\nThe number of quota units consumed by a request varies depending on the method\ncalled. The following table outlines the per-method quota unit usage:\n\n| Method | Quota Units |\n|---------------------------------------|-------------|\n| `drafts.create` | 10 |\n| `drafts.delete` | 10 |\n| `drafts.get` | 5 |\n| `drafts.list` | 5 |\n| `drafts.send` | 100 |\n| `drafts.update` | 15 |\n| `getProfile` | 1 |\n| `history.list` | 2 |\n| `labels.create` | 5 |\n| `labels.delete` | 5 |\n| `labels.get` | 1 |\n| `labels.list` | 1 |\n| `labels.update` | 5 |\n| `messages.attachments.get` | 5 |\n| `messages.batchDelete` | 50 |\n| `messages.batchModify` | 50 |\n| `messages.delete` | 10 |\n| `messages.get` | 5 |\n| `messages.import` | 25 |\n| `messages.insert` | 25 |\n| `messages.list` | 5 |\n| `messages.modify` | 5 |\n| `messages.send` | 100 |\n| `messages.trash` | 5 |\n| `messages.untrash` | 5 |\n| `settings.delegates.create` | 100 |\n| `settings.delegates.delete` | 5 |\n| `settings.delegates.get` | 1 |\n| `settings.delegates.list` | 1 |\n| `settings.filters.create` | 5 |\n| `settings.filters.delete` | 5 |\n| `settings.filters.get` | 1 |\n| `settings.filters.list` | 1 |\n| `settings.forwardingAddresses.create` | 100 |\n| `settings.forwardingAddresses.delete` | 5 |\n| `settings.forwardingAddresses.get` | 1 |\n| `settings.forwardingAddresses.list` | 1 |\n| `settings.getAutoForwarding` | 1 |\n| `settings.getImap` | 1 |\n| `settings.getPop` | 1 |\n| `settings.getVacation` | 1 |\n| `settings.sendAs.create` | 100 |\n| `settings.sendAs.delete` | 5 |\n| `settings.sendAs.get` | 1 |\n| `settings.sendAs.list` | 1 |\n| `settings.sendAs.update` | 100 |\n| `settings.sendAs.verify` | 100 |\n| `settings.updateAutoForwarding` | 5 |\n| `settings.updateImap` | 5 |\n| `settings.updatePop` | 100 |\n| `settings.updateVacation` | 5 |\n| `stop` | 50 |\n| `threads.delete` | 20 |\n| `threads.get` | 10 |\n| `threads.list` | 10 |\n| `threads.modify` | 10 |\n| `threads.trash` | 10 |\n| `threads.untrash` | 10 |\n| `watch` | 100 |"]]