API Gmail tuân theo cá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 giới hạn sử dụng được áp dụng đồng thời: giới hạn sử dụng cho mỗi dự án và giới hạn 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á |
---|---|---|
Giới hạn tốc độ trên mỗi dự án | 1.200.000 đơn vị hạn mức mỗi phút | rateLimitExceeded |
Giới hạn tốc độ trên mỗi người dùng | 15.000 đơn vị hạn mức/người dùng/phút | userRateLimitExceeded |
Mức sử dụng hạn mức 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 đơn vị hạn mức trên mỗi 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.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 |