מגבלות שימוש

יש מגבלות שימוש על Gmail API, שמגבילות את הקצב שבו אפשר לקרוא לשיטות של ה-API. המגבלות מוגדרות במונחים של יחידות מכסה, יחידת מידה מופשטת שמייצגת את השימוש במשאבי Gmail. יש שתי מגבלות שימוש שחלות בו-זמנית: מגבלת שימוש לכל פרויקט ומגבלת שימוש לכל משתמש. בטבלה הבאה מפורטות מגבלות השימוש האלה:

סוג מגבלת השימוש	מגבלה	הסיבה לחריגה
מגבלת קצב לכל פרויקט	‫1,200,000 יחידות מכסה לדקה	rateLimitExceeded
הגבלת קצב לכל משתמש	‫15,000 יחידות מכסה למשתמש לדקה	userRateLimitExceeded

הערה: מידע על טיפול בשגיאות שקשורות למגבלות זמין במאמר פתרון שגיאות.

ניצול המכסה לכל שיטה

מספר יחידות המכסה שנצרכות על ידי בקשה משתנה בהתאם לשיטה שנקראה. בטבלה הבאה מפורט השימוש ביחידות המכסה לכל שיטה:

שיטה	יחידות מכסה
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