API جیمیل مشمول محدودیتهای استفاده است که نرخ فراخوانی متدهای API را محدود میکند. محدودیتها بر اساس واحدهای سهمیه تعریف میشوند، یک واحد انتزاعی اندازهگیری که نشاندهنده میزان استفاده از منابع جیمیل است. دو محدودیت استفاده وجود دارد که به طور همزمان اعمال میشوند: یک محدودیت نرخ به ازای هر پروژه و یک محدودیت نرخ به ازای هر کاربر.
جدول زیر جزئیات این محدودیتها را نشان میدهد:
| نوع محدودیت استفاده | حد | کد خطا |
|---|---|---|
| محدودیت نرخ هر پروژه | ۱،۲۰۰،۰۰۰ واحد سهمیهای در دقیقه | rateLimitExceeded |
| محدودیت نرخ به ازای هر کاربر | ۱۵۰۰۰ واحد سهمیه در دقیقه برای هر کاربر | userRateLimitExceeded |
برای اطلاعات در مورد مدیریت خطاهای محدود، به رفع خطاها مراجعه کنید.
سهمیه استفاده به ازای هر متد
تعداد واحدهای سهمیه مصرف شده توسط یک درخواست بسته به متد فراخوانی شده متفاوت است. جدول زیر میزان استفاده از واحد سهمیه به ازای هر متد را نشان میدهد:
| روش | واحدهای سهمیهای |
|---|---|
drafts.create | ۱۰ |
drafts.delete | ۱۰ |
drafts.get | ۵ |
drafts.list | ۵ |
drafts.send | ۱۰۰ |
drafts.update | ۱۵ |
getProfile | ۱ |
history.list | ۲ |
labels.create | ۵ |
labels.delete | ۵ |
labels.get | ۱ |
labels.list | ۱ |
labels.update | ۵ |
messages.attachments.get | ۵ |
messages.batchDelete | ۵۰ |
messages.batchModify | ۵۰ |
messages.delete | ۱۰ |
messages.get | ۵ |
messages.import | ۲۵ |
messages.insert | ۲۵ |
messages.list | ۵ |
messages.modify | ۵ |
messages.send | ۱۰۰ |
messages.trash | ۵ |
messages.untrash | ۵ |
settings.delegates.create | ۱۰۰ |
settings.delegates.delete | ۵ |
settings.delegates.get | ۱ |
settings.delegates.list | ۱ |
settings.filters.create | ۵ |
settings.filters.delete | ۵ |
settings.filters.get | ۱ |
settings.filters.list | ۱ |
settings.forwardingAddresses.create | ۱۰۰ |
settings.forwardingAddresses.delete | ۵ |
settings.forwardingAddresses.get | ۱ |
settings.forwardingAddresses.list | ۱ |
settings.getAutoForwarding | ۱ |
settings.getImap | ۱ |
settings.getPop | ۱ |
settings.getVacation | ۱ |
settings.sendAs.create | ۱۰۰ |
settings.sendAs.delete | ۵ |
settings.sendAs.get | ۱ |
settings.sendAs.list | ۱ |
settings.sendAs.update | ۱۰۰ |
settings.sendAs.verify | ۱۰۰ |
settings.updateAutoForwarding | ۵ |
settings.updateImap | ۵ |
settings.updatePop | ۱۰۰ |
settings.updateVacation | ۵ |
stop | ۵۰ |
threads.delete | ۲۰ |
threads.get | ۱۰ |
threads.list | ۱۰ |
threads.modify | ۱۰ |
threads.trash | ۱۰ |
threads.untrash | ۱۰ |
watch | ۱۰۰ |
هنگام استفاده از Gmail API، محدودیت ۵۰۰ گیرنده برای هر پیام ایمیل نیز وجود دارد.
خطاهای سهمیهبندی مبتنی بر زمان را برطرف کنید
برای همه خطاهای مبتنی بر زمان (حداکثر N درخواست در هر X دقیقه)، توصیه میکنیم کد شما استثنا را دریافت کند و از یک backoff نمایی کوتاه شده استفاده کند تا مطمئن شود دستگاههای شما بار اضافی تولید نمیکنند.
بازگشت نمایی یک استراتژی استاندارد مدیریت خطا برای برنامههای شبکه است. یک الگوریتم بازگشت نمایی، درخواستها را با استفاده از زمان انتظار بین درخواستها که به صورت نمایی افزایش مییابد، تا حداکثر زمان بازگشت، دوباره امتحان میکند. اگر درخواستها همچنان ناموفق باشند، مهم است که تأخیر بین درخواستها به مرور زمان افزایش یابد تا درخواست موفقیتآمیز شود.
الگوریتم مثال
یک الگوریتم بازگشت نمایی، درخواستها را به صورت نمایی دوباره امتحان میکند و زمان انتظار بین تلاشهای مجدد را تا حداکثر زمان بازگشت افزایش میدهد. برای مثال:
- یک درخواست به Gmail API ارسال کنید.
- اگر درخواست با شکست مواجه شد، ۱ +
random_number_millisecondsصبر کنید و درخواست را دوباره امتحان کنید. - اگر درخواست با شکست مواجه شد، به مدت ۲ +
random_number_millisecondsصبر کنید و درخواست را دوباره امتحان کنید. - اگر درخواست با شکست مواجه شد، به مدت ۴ +
random_number_millisecondsصبر کنید و درخواست را دوباره امتحان کنید. - و به همین ترتیب، تا زمان
maximum_backoff. - تا حداکثر تعداد دفعات تلاش مجدد، به انتظار و تلاش مجدد ادامه دهید، اما مدت زمان انتظار بین تلاشها را افزایش ندهید.
کجا:
- زمان انتظار
min(((2^n)+random_number_milliseconds), maximum_backoff)است، که در آنnبرای هر تکرار (درخواست) 1 واحد افزایش مییابد. -
random_number_millisecondsیک عدد تصادفی میلیثانیه کمتر یا مساوی ۱۰۰۰ است. این به جلوگیری از مواردی که بسیاری از کلاینتها به دلیل برخی شرایط همگامسازی میشوند و همه به طور همزمان تلاش مجدد میکنند و درخواستها را در امواج هماهنگ ارسال میکنند، کمک میکند. مقدارrandom_number_millisecondsپس از هر درخواست تلاش مجدد دوباره محاسبه میشود. -
maximum_backoffمعمولاً ۳۲ یا ۶۴ ثانیه است. مقدار مناسب به مورد استفاده بستگی دارد.
کلاینت میتواند پس از رسیدن به زمان maximum_backoff به تلاش مجدد ادامه دهد. تلاشهای مجدد پس از این نقطه نیازی به افزایش مداوم زمان backoff ندارند. برای مثال، اگر یک کلاینت از زمان maximum_backoff برابر با ۶۴ ثانیه استفاده کند، پس از رسیدن به این مقدار، کلاینت میتواند هر ۶۴ ثانیه دوباره تلاش کند. در مقطعی، کلاینتها باید از تلاش مجدد نامحدود منع شوند.
زمان انتظار بین تلاشهای مجدد و تعداد تلاشهای مجدد به مورد استفاده شما و شرایط شبکه بستگی دارد.
قیمتگذاری
تمام استفاده از Gmail API بدون هیچ هزینه اضافی در دسترس است. تجاوز از محدودیت درخواست سهمیه، هزینه اضافی ندارد و از حساب شما صورتحسابی کسر نمیشود.
درخواست افزایش سهمیه
بسته به میزان استفاده از منابع پروژهتان، ممکن است بخواهید درخواست تنظیم سهمیه بدهید. فراخوانیهای API توسط یک حساب کاربری سرویس، به عنوان استفاده از یک حساب کاربری واحد در نظر گرفته میشوند. درخواست برای سهمیه تنظیمشده، تضمینی برای تأیید نیست. درخواستهای تنظیم سهمیه که مقدار سهمیه را به میزان قابل توجهی افزایش میدهند، ممکن است مدت زمان بیشتری طول بکشد تا تأیید شوند.
همه پروژهها سهمیههای یکسانی ندارند. با گذشت زمان و افزایش استفاده از گوگل کلود، ممکن است لازم باشد مقادیر سهمیه شما افزایش یابد. اگر انتظار افزایش قابل توجه استفاده در آینده را دارید، میتوانید به صورت پیشگیرانه از صفحه سهمیهها در کنسول گوگل کلود، درخواست تنظیم سهمیه کنید .
برای مطالعه بیشتر، به منابع زیر مراجعه کنید:
- درباره تعدیل سهمیهها
- مشاهده میزان استفاده و محدودیتهای سهمیه فعلی شما
- درخواست محدودیت سهمیه بالاتر