حدود الاستخدام
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تخضع واجهة برمجة التطبيقات Gmail API لحدود الاستخدام التي تقيّد معدّل إمكانية استدعاء طرق واجهة برمجة التطبيقات. يتم تحديد الحدود من حيث وحدات الحصة
المحدودة ، وهي وحدة قياس مجرّدة تمثّل
استخدام موارد Gmail. هناك حدّان للاستخدام يتم تطبيقهما في الوقت نفسه: حدّ للاستخدام لكل مشروع وحدّ للاستخدام لكل مستخدم. يوضّح الجدول التالي تفاصيل حدود الاستخدام هذه:
نوع حد الاستخدام
الحدّ
سبب التجاوز
الحدّ الأقصى لمعدّل الطلبات لكل مشروع
1,200,000 وحدة حصة في الدقيقة
rateLimitExceeded
الحد الأقصى لمعدّل الإرسال لكل مستخدم
15,000 وحدة حصة لكل مستخدم في الدقيقة
userRateLimitExceeded
ملاحظة: للحصول على معلومات حول التعامل مع أخطاء الحدّ الأقصى، يُرجى الرجوع إلى حلّ الأخطاء . مقدار استخدام الحصة لكل طريقة
يختلف عدد وحدات الحصة المستهلكة من خلال الطلب حسب الطريقة التي تم استدعاؤها. يوضّح الجدول التالي استخدام وحدات الحصة لكل طريقة:
الطريقة
وحدات الحصة
drafts.create10
drafts.delete10
drafts.get5
drafts.list5
drafts.send100
drafts.update15
getProfile1
history.list2
labels.create5
labels.delete5
labels.get1
labels.list1
labels.update5
messages.attachments.get5
messages.batchDelete50
messages.batchModify50
messages.delete10
messages.get5
messages.import25
messages.insert25
messages.list5
messages.modify5
messages.send100
messages.trash5
messages.untrash5
settings.delegates.create100
settings.delegates.delete5
settings.delegates.get1
settings.delegates.list1
settings.filters.create5
settings.filters.delete5
settings.filters.get1
settings.filters.list1
settings.forwardingAddresses.create100
settings.forwardingAddresses.delete5
settings.forwardingAddresses.get1
settings.forwardingAddresses.list1
settings.getAutoForwarding1
settings.getImap1
settings.getPop1
settings.getVacation1
settings.sendAs.create100
settings.sendAs.delete5
settings.sendAs.get1
settings.sendAs.list1
settings.sendAs.update100
settings.sendAs.verify100
settings.updateAutoForwarding5
settings.updateImap5
settings.updatePop100
settings.updateVacation5
stop50
threads.delete20
threads.get10
threads.list10
threads.modify10
threads.trash10
threads.untrash10
watch100
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0 . للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers . إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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 |"]]
