برای اطمینان از پایداری سیستم و توزیع عادلانه منابع، رابط برنامهنویسی کاربردی (API) گوگل هلث محدودیتهای سرعت را برای درخواستهای ورودی API اعمال میکند.
در حالی که سهمیههای پیشفرض برای تطبیق با اکثر موارد استفاده استاندارد طراحی شدهاند، برنامههایی که از این آستانهها تجاوز کنند، مسدود خواهند شد.
مدیریت خطاهای محدودیت نرخ
وقتی برنامه شما از حد مجاز نرخ اختصاص داده شده فراتر رود، API درخواست را رد میکند و خطای 429 Too Many Requests را برمیگرداند. برای کاهش خطا، برنامه شما باید ارسال درخواستها را متوقف کرده و منطق retry را پیادهسازی کند تا رویدادهای محدودکننده نرخ را به طور مناسب مدیریت کند.
محدودیتهای پیشفرض و تحلیل تأثیر
محدودیتهای سرعت در فواصل روزانه، دقیقهای و به ازای هر کاربر ارزیابی میشوند. تحلیل تأثیر، چگونگی تبدیل این سهمیهها به تعداد درخواستها در ثانیه (QPS) را شرح میدهد.
| متریک | محدودیت پیشفرض | تحلیل تأثیر QPS |
|---|---|---|
| به ازای هر پروژه (روزانه) | ۸۶.۴ میلیون درخواست در روز | حدود ۱۰۰۰ QPS پایدار |
| به ازای هر پروژه (به صورت دقیقهای) | ۱۲۰،۰۰۰ درخواست در دقیقه | حدود ۲۰۰۰ QPS برست |
| به ازای هر کاربر (به صورت دقیقهای) | ۳۰۰ درخواست در دقیقه | استاندارد : ۵ QPS برای هر کاربر برنامههای تأیید نشده : حداکثر ۲۵۰ QPS در مجموع (حداکثر ۱۰۰ کاربر @ ۲.۵ QPS برای هر کاربر) |
درخواست افزایش سهمیه
اگر برنامه شما به توان عملیاتی بالاتری نسبت به تخصیصهای پیشفرض ارائه شده نیاز دارد، میتوانید از طریق کنسول ابری گوگل درخواست تنظیم آن را بدهید. به بخش «مشاهده و مدیریت سهمیهها» مراجعه کنید.