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

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