سهمیه‌ها و حد نرخ

برای اطمینان از پایداری سیستم و توزیع عادلانه منابع، Google Health API محدودیت‌های نرخ را بر درخواست‌های ورودی API اعمال می‌کند.

درحالی‌که سهمیه‌های پیش‌فرض برای پاسخگویی به اکثریت قریب به اتفاق موارد استفاده استاندارد طراحی شده‌اند، برنامه‌هایی که از این آستانه‌ها فراتر بروند، محدود خواهند شد.

رسیدگی به خطاهای گذرا و محدودیت نرخ

وقتی برنامه شما از حد نرخ اختصاص‌یافته فراتر می‌رود، API درخواست را رد می‌کند و 429 Too Many Requests (RESOURCE_EXHAUSTED) را برمی‌گرداند. مشکلات گذرا در سرور نیز می‌تواند 503 Service Unavailable (UNAVAILABLE) یا 504 Gateway Timeout (DEADLINE_EXCEEDED) را برگرداند.

برای رسیدگی مطمئن به این پاسخ‌ها بدون افزایش بار، منطق امتحان مجدد را با عقب‌گرد نمایی و لرزش تصادفی در پاسخ‌های 429 RESOURCE_EXHAUSTED، 503 UNAVAILABLE، و 504 DEADLINE_EXCEEDED پیاده‌سازی کنید. از تلاش مجدد فوری خودداری کنید، زیرا این کار باعث تشدید ازدحام و افزایش محدودسازی تکراری یا اتمام مهلت می‌شود.

محدودیت‌های پیش‌فرض و تحلیل تأثیر

حدود نرخ در فواصل روزانه، دقیقه‌ای، و به‌ازای هر کاربر ارزیابی می‌شود. تجزیه‌وتحلیل تأثیر نشان می‌دهد که این سهمیه‌ها چگونه به پُرسمان در ثانیه (QPS) تبدیل می‌شوند.

متریک محدودیت پیش‌فرض تحلیل تأثیر QPS
به‌ازای هر پروژه (روزانه) ‫۸۶٫۴ میلیون درخواست در روز ~۱۰۰۰ پُرسمان در ثانیه پایدار
به‌ازای هر پروژه (دقیقه‌ای) ‫۱۲۰٬۰۰۰ درخواست در دقیقه ~۲۰۰۰ انفجار QPS
به‌ازای هر کاربر (دقیقه‌ای) ‫۳۰۰ درخواست در دقیقه استاندارد: ۵ درخواست در ثانیه برای هر کاربر
برنامه‌های تأییدنشده: حداکثر ۲۵۰ درخواست در ثانیه در مجموع (محدود به ۱۰۰ کاربر با ۲٫۵ درخواست در ثانیه برای هر کاربر)

حدود نرخ اعطای کد OAuth

‫Google Cloud برای کنترل سرعت ورود کاربران جدید یا اصالت‌سنجی مجدد کاربران در برنامه شما، حد مجاز نرخ را برای اعطای کد OAuth اعمال می‌کند. اگر انتظار دارید که در یک بازه زمانی ۲۴ ساعته، تعداد ثبت‌نام‌ها یا اصالت‌سنجی‌های مجدد کاربران از ۱۰٬۰۰۰ فراتر رود، ازقبل درخواست سهمیه بالاتری بدهید. برای اطلاعات بیشتر، حدود نرخ برنامه OAuth را ببینید.

درخواست کردن افزایش سهمیه

اگر برنامه شما به توان عملیاتی بالاتری نسبت‌به تخصیص‌های پیش‌فرض ارائه‌شده نیاز دارد، می‌توانید ازطریق Google Cloud Console درخواست اصلاح کنید. مشاهده و مدیریت سهمیه‌ها را ببینید.