حدود الاستخدام

تخضع واجهة برمجة التطبيقات Gmail 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