حدود استفاده

ازآنجاکه Google Forms API یک سرویس مشترک است، ما سهمیه‌ها و محدودیت‌هایی را اعمال می‌کنیم تا مطمئن شویم که همه کاربران به‌طور عادلانه از آن استفاده می‌کنند و از سلامت کلی سیستم Google Workspace محافظت کنیم.

اگر از سهمیه فراتر بروید، معمولاً پاسخ رمز وضعیت HTTP 429: Too many requests را دریافت خواهید کرد. اگر این اتفاق افتاد، باید از الگوریتم عقب‌نشینی نمایی استفاده کنید و بعداً دوباره امتحان کنید. به‌شرطی که در محدوده سهمیه‌های دقیقه‌ای زیر بمانید، هیچ محدودیتی برای تعداد درخواست‌هایی که می‌توانید در روز انجام دهید وجود ندارد.

توجه: ساعت‌های فرم محدودیت‌های بیشتری دارند. برای اطلاعات بیشتر، راه‌اندازی و دریافت اعلان‌های لحظه‌ای را ببینید.

جدول زیر جزئیات محدودیت‌های درخواست را نشان می‌دهد:

سهمیه‌ها
درخواست‌های خواندن
در روز برای هر پروژه نامحدود
در دقیقه برای هر پروژه 975
در دقیقه برای هر کاربر برای هر پروژه 390
درخواست‌های خواندن گران‌قیمت

(برای forms.responses.list درخواست استفاده شده است.)

در روز برای هر پروژه نامحدود
در دقیقه برای هر پروژه ۴۵۰
در دقیقه برای هر کاربر برای هر پروژه ۱۸۰
درخواست‌های نوشتن
در روز برای هر پروژه نامحدود
در دقیقه برای هر پروژه 375
در دقیقه برای هر کاربر برای هر پروژه ۱۵۰

حل‌وفصل کردن خطاهای سهمیه زمان‌محور

برای همه خطاهای مبتنی بر زمان (حداکثر N درخواست در هر X دقیقه)، توصیه می‌کنیم کد شما استثنا را بگیرد و از عقب‌نشینی نمایی کوتاه استفاده کند تا مطمئن شوید دستگاه‌هایتان بار اضافی تولید نمی‌کنند.

عقب‌نشینی نمایی یک استراتژی استاندارد رسیدگی به خطا برای برنامه‌های شبکه است. الگوریتم عقب‌گرد نمایی درخواست‌ها را بااستفاده از زمان‌های انتظار به‌صورت نمایی افزایشی بین درخواست‌ها، تا حداکثر زمان عقب‌گرد، دوباره امتحان می‌کند. اگر درخواست‌ها همچنان ناموفق بود، مهم است که تأخیر بین درخواست‌ها به‌مرور زمان افزایش یابد تا درخواست موفقیت‌آمیز شود.

الگوریتم نمونه

الگوریتم عقب‌گرد نمایی درخواست‌ها را به‌صورت نمایی امتحان مجدد می‌کند و زمان انتظار بین امتحان‌های مجدد را تا حداکثر زمان عقب‌گرد افزایش می‌دهد. برای مثال:

  1. درخواستی به Google Forms API ارسال کنید.
  2. اگر درخواست ناموفق بود، random_number_milliseconds + ۱ صبر کنید و درخواست را دوباره امتحان کنید.
  3. اگر درخواست ناموفق بود، random_number_milliseconds + ۲ صبر کنید و درخواست را دوباره امتحان کنید.
  4. اگر درخواست ناموفق بود، random_number_milliseconds + ۴ صبر کنید و درخواست را دوباره امتحان کنید.
  5. و به همین ترتیب، تا maximum_backoff بار.
  6. به انتظار و تلاش مجدد تا حداکثر تعداد تلاش مجدد ادامه دهید، اما دوره انتظار بین تلاش‌های مجدد را افزایش ندهید.

where:

  • زمان انتظار min(((2^n)+random_number_milliseconds), maximum_backoff) است، و n برای هر تکرار (درخواست) ۱ عدد افزایش می‌یابد.
  • ‫random_number_milliseconds عدد تصادفی از میلی‌ثانیه‌ها است که کمتر یا مساوی ۱۰۰۰ است. این کار کمک می‌کند از مواردی که در آن بسیاری از کارخواه‌ها به‌دلیل شرایطی همگام‌سازی می‌شوند و همه به‌طور هم‌زمان دوباره امتحان می‌کنند و درخواست‌ها را در موج‌های همگام‌سازی‌شده ارسال می‌کنند، جلوگیری شود. مقدار random_number_milliseconds پس‌از هر درخواست تکرار مجدد دوباره محاسبه می‌شود.
  • maximum_backoff معمولاً ۳۲ یا ۶۴ ثانیه است. مقدار مناسب به مورد استفاده بستگی دارد.

مشتری می‌تواند پس‌از رسیدن به زمان maximum_backoff، به تلاش مجدد ادامه دهد. تلاش‌های مجدد پس‌از این نقطه نیازی به ادامه افزایش زمان عقب‌نشینی ندارند. برای مثال، اگر کارخواهی از زمان maximum_backoff ۶۴ ثانیه استفاده کند، پس‌از رسیدن به این مقدار، کارخواه می‌تواند هر ۶۴ ثانیه دوباره امتحان کند. در نقطه‌ای، باید از تلاش مجدد نامحدود کارخواه‌ها جلوگیری شود.

زمان انتظار بین تلاش‌های مجدد و تعداد تلاش‌های مجدد به مورد استفاده شما و شرایط شبکه بستگی دارد.

قیمت‌گذاری

همه استفاده‌های استاندارد از Google Forms API بدون هزینه اضافی دردسترس است. فراتر رفتن از حدود درخواست سهمیه قرار است در اواخر سال ۲۰۲۶ برای حساب صورت‌حساب Google Cloud شما هزینه داشته باشد. برای اطلاعات بیشتر، مدل استانداردشده Google Workspace برای میاناهای برنامه‌سازی کاربردی و ابزارهای نماینده را ببینید.

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

بسته به میزان استفاده از منابع پروژه‌تان، ممکن است بخواهید درخواست تعدیل سهمیه کنید. فراخوانی‌های API توسط حساب سرویس به‌عنوان استفاده از یک حساب واحد درنظر گرفته می‌شود. درخواست برای سهمیه اصلاح‌شده تضمینی برای تأیید نیست. درخواست‌های تعدیل سهمیه که مقدار سهمیه را به‌طور قابل‌توجهی افزایش می‌دهند ممکن است برای تأیید شدن به زمان بیشتری نیاز داشته باشند.

همه پروژه‌ها سهمیه‌های یکسانی ندارند. با گذشت زمان و افزایش استفاده شما از Google Cloud، ممکن است لازم باشد مقادیر سهمیه شما افزایش یابد. اگر انتظار دارید در آینده نزدیک افزایش قابل‌توجهی در استفاده داشته باشید، می‌توانید به‌طور پیش‌گیرانه از صفحه سهمیه‌ها و حدود سیستم در کنسول Google Cloud درخواست اصلاح سهمیه کنید.

برای اطلاعات بیشتر، منابع زیر را ببینید: