از آنجایی که Google Drive API یک سرویس مشترک است، برای اطمینان از استفاده منصفانه توسط همه کاربران و محافظت از عملکرد کلی سیستم Google Workspace، سهمیه‌ها و محدودیت‌هایی اعمال می‌کنیم.
اعلان‌هایی که هنگام باز کردن کانال اعلان به آدرسی که مشخص شده است، در محدودیت‌های سهمیه شما به حساب نمی‌آیند. با این حال، تماس با روش‌های changes.watch ، channels.stop و files.watch در سهمیه شما حساب می‌شود.
اگر از یک سهمیه فراتر رفتید، پاسخ کد وضعیت HTTP 403: User rate limit exceeded . بررسی‌های محدودیت نرخ اضافی در پشتیبان Drive نیز ممکن است پاسخ 429: Too many requests را ایجاد کند. اگر این اتفاق افتاد، باید از الگوریتم عقب‌نشینی نمایی استفاده کنید و بعداً دوباره امتحان کنید. به شرطی که در سهمیه‌های هر دقیقه زیر بمانید، محدودیتی برای تعداد درخواست‌هایی که می‌توانید در روز انجام دهید وجود ندارد.
جدول زیر محدودیت های پرس و جو را شرح می دهد:
| سهمیه ها | |||||
|---|---|---|---|---|---|
| پرس و جوها |
| ||||
خطاهای سهمیه بندی مبتنی بر زمان را برطرف کنید
برای همه خطاهای مبتنی بر زمان (حداکثر N درخواست در هر X دقیقه)، توصیه می‌کنیم کد شما استثنا باشد و از یک عقب‌نشینی نمایی کوتاه‌شده استفاده کند تا مطمئن شود دستگاه‌های شما بار بیش از حد تولید نمی‌کنند.
عقب نشینی نمایی یک استراتژی مدیریت خطای استاندارد برای برنامه های شبکه است. یک الگوریتم عقب‌نشینی نمایی، درخواست‌ها را با استفاده از افزایش تصاعدی زمان انتظار بین درخواست‌ها، تا حداکثر زمان عقب‌نشینی، دوباره امتحان می‌کند. اگر درخواست‌ها همچنان ناموفق هستند، مهم است که تأخیر بین درخواست‌ها در طول زمان افزایش یابد تا درخواست موفقیت‌آمیز شود.
الگوریتم نمونه
یک الگوریتم عقب‌نشینی نمایی، درخواست‌ها را به‌صورت تصاعدی دوباره امتحان می‌کند، و زمان انتظار بین تلاش‌های مجدد را تا حداکثر زمان عقب‌نشینی افزایش می‌دهد. به عنوان مثال:
- از Google Drive API درخواست کنید.
- اگر درخواست ناموفق بود، 1 +
random_number_millisecondsصبر کنید و درخواست را دوباره امتحان کنید. - اگر درخواست ناموفق بود، 2 +
random_number_millisecondsصبر کنید و دوباره درخواست را امتحان کنید. - اگر درخواست ناموفق بود، 4 +
random_number_millisecondsصبر کنید و دوباره درخواست را امتحان کنید. - و به همین ترتیب، تا
maximum_backoff. - به انتظار و تلاش مجدد تا حداکثر تعداد دفعات مجدد ادامه دهید، اما دوره انتظار بین تلاش های مجدد را افزایش ندهید.
کجا:
- زمان انتظار
min(((2^n)+random_number_milliseconds), maximum_backoff)است، کهnبرای هر تکرار (درخواست) 1 افزایش می یابد. -
random_number_millisecondsتعداد تصادفی میلی ثانیه کمتر یا مساوی 1000 است. این به جلوگیری از مواردی کمک می کند که در آن بسیاری از مشتریان با برخی موقعیت ها همگام می شوند و همه یکباره دوباره تلاش می کنند و درخواست ها را در امواج همگام ارسال می کنند. مقدارrandom_number_millisecondsپس از هر درخواست مجدد محاسبه می شود. -
maximum_backoffمعمولاً 32 یا 64 ثانیه است. مقدار مناسب بستگی به مورد استفاده دارد.
مشتری می تواند پس از رسیدن به maximum_backoff زمان بازگشت مجدد به تلاش مجدد ادامه دهد. تلاش مجدد بعد از این مرحله نیازی به افزایش زمان عقب نشینی ندارد. به عنوان مثال، اگر یک کلاینت از maximum_backoff 64 ثانیه استفاده کند، پس از رسیدن به این مقدار، مشتری می تواند هر 64 ثانیه یکبار دوباره امتحان کند. در برخی موارد، مشتریان باید از تلاش مجدد به طور نامحدود جلوگیری شوند.
زمان انتظار بین تلاش های مجدد و تعداد دفعات مجدد بستگی به حالت استفاده و شرایط شبکه شما دارد.
قیمت گذاری
تمام استفاده از Google Drive API بدون هزینه اضافی در دسترس است. فراتر از محدودیت های درخواست سهمیه هزینه اضافی ندارد و حساب شما صورتحساب نمی شود.
درخواست افزایش سهمیه
بسته به میزان استفاده از منابع پروژه شما، ممکن است بخواهید درخواست افزایش سهمیه کنید. تماس‌های API توسط یک حساب سرویس به عنوان استفاده از یک حساب واحد در نظر گرفته می‌شود. درخواست برای افزایش سهمیه تضمینی برای تایید نیست. افزایش سهمیه های بزرگ ممکن است مدت بیشتری طول بکشد تا تصویب شود.
همه پروژه ها سهمیه یکسانی ندارند. از آنجایی که در طول زمان به طور فزاینده ای از Google Cloud استفاده می کنید، ممکن است نیاز باشد که سهمیه های شما افزایش یابد. اگر انتظار افزایش چشمگیر استفاده در آینده را دارید، می‌توانید به طور فعالانه از صفحه سهمیه‌ها در کنسول Google Cloud درخواست تنظیمات سهمیه کنید .
برای کسب اطلاعات بیشتر به منابع زیر مراجعه کنید:
- درباره درخواست های افزایش سهمیه
- میزان استفاده و محدودیت های فعلی خود را مشاهده کنید
- درخواست محدودیت سهمیه بالاتر
از آنجایی که Google Drive API یک سرویس مشترک است، برای اطمینان از استفاده منصفانه توسط همه کاربران و محافظت از عملکرد کلی سیستم Google Workspace، سهمیه‌ها و محدودیت‌هایی اعمال می‌کنیم.
اعلان‌هایی که هنگام باز کردن کانال اعلان به آدرسی که مشخص شده است، در محدودیت‌های سهمیه شما به حساب نمی‌آیند. با این حال، تماس با روش‌های changes.watch ، channels.stop و files.watch در سهمیه شما حساب می‌شود.
اگر از یک سهمیه فراتر رفتید، پاسخ کد وضعیت HTTP 403: User rate limit exceeded . بررسی‌های محدودیت نرخ اضافی در پشتیبان Drive نیز ممکن است پاسخ 429: Too many requests را ایجاد کند. اگر این اتفاق افتاد، باید از الگوریتم عقب‌نشینی نمایی استفاده کنید و بعداً دوباره امتحان کنید. به شرطی که در سهمیه‌های هر دقیقه زیر بمانید، محدودیتی برای تعداد درخواست‌هایی که می‌توانید در روز انجام دهید وجود ندارد.
جدول زیر محدودیت های پرس و جو را شرح می دهد:
| سهمیه ها | |||||
|---|---|---|---|---|---|
| پرس و جوها |
| ||||
خطاهای سهمیه بندی مبتنی بر زمان را برطرف کنید
برای همه خطاهای مبتنی بر زمان (حداکثر N درخواست در هر X دقیقه)، توصیه می‌کنیم کد شما استثنا باشد و از یک عقب‌نشینی نمایی کوتاه‌شده استفاده کند تا مطمئن شود دستگاه‌های شما بار بیش از حد تولید نمی‌کنند.
عقب نشینی نمایی یک استراتژی مدیریت خطای استاندارد برای برنامه های شبکه است. یک الگوریتم عقب‌نشینی نمایی، درخواست‌ها را با استفاده از افزایش تصاعدی زمان انتظار بین درخواست‌ها، تا حداکثر زمان عقب‌نشینی، دوباره امتحان می‌کند. اگر درخواست‌ها همچنان ناموفق هستند، مهم است که تأخیر بین درخواست‌ها در طول زمان افزایش یابد تا درخواست موفقیت‌آمیز شود.
الگوریتم نمونه
یک الگوریتم عقب‌نشینی نمایی، درخواست‌ها را به‌صورت تصاعدی دوباره امتحان می‌کند، و زمان انتظار بین تلاش‌های مجدد را تا حداکثر زمان عقب‌نشینی افزایش می‌دهد. به عنوان مثال:
- از Google Drive API درخواست کنید.
- اگر درخواست ناموفق بود، 1 +
random_number_millisecondsصبر کنید و درخواست را دوباره امتحان کنید. - اگر درخواست ناموفق بود، 2 +
random_number_millisecondsصبر کنید و دوباره درخواست را امتحان کنید. - اگر درخواست ناموفق بود، 4 +
random_number_millisecondsصبر کنید و دوباره درخواست را امتحان کنید. - و به همین ترتیب، تا
maximum_backoff. - به انتظار و تلاش مجدد تا حداکثر تعداد دفعات مجدد ادامه دهید، اما دوره انتظار بین تلاش های مجدد را افزایش ندهید.
کجا:
- زمان انتظار
min(((2^n)+random_number_milliseconds), maximum_backoff)است، کهnبرای هر تکرار (درخواست) 1 افزایش می یابد. -
random_number_millisecondsتعداد تصادفی میلی ثانیه کمتر یا مساوی 1000 است. این به جلوگیری از مواردی کمک می کند که در آن بسیاری از مشتریان با برخی موقعیت ها همگام می شوند و همه یکباره دوباره تلاش می کنند و درخواست ها را در امواج همگام ارسال می کنند. مقدارrandom_number_millisecondsپس از هر درخواست مجدد محاسبه می شود. -
maximum_backoffمعمولاً 32 یا 64 ثانیه است. مقدار مناسب بستگی به مورد استفاده دارد.
مشتری می تواند پس از رسیدن به maximum_backoff زمان بازگشت مجدد به تلاش مجدد ادامه دهد. تلاش مجدد بعد از این مرحله نیازی به افزایش زمان عقب نشینی ندارد. به عنوان مثال، اگر یک کلاینت از maximum_backoff 64 ثانیه استفاده کند، پس از رسیدن به این مقدار، مشتری می تواند هر 64 ثانیه یکبار دوباره امتحان کند. در برخی موارد، مشتریان باید از تلاش مجدد به طور نامحدود جلوگیری شوند.
زمان انتظار بین تلاش های مجدد و تعداد دفعات مجدد بستگی به حالت استفاده و شرایط شبکه شما دارد.
قیمت گذاری
تمام استفاده از Google Drive API بدون هزینه اضافی در دسترس است. فراتر از محدودیت های درخواست سهمیه هزینه اضافی ندارد و حساب شما صورتحساب نمی شود.
درخواست افزایش سهمیه
بسته به میزان استفاده از منابع پروژه شما، ممکن است بخواهید درخواست افزایش سهمیه کنید. تماس‌های API توسط یک حساب سرویس به عنوان استفاده از یک حساب واحد در نظر گرفته می‌شود. درخواست برای افزایش سهمیه تضمینی برای تایید نیست. افزایش سهمیه های بزرگ ممکن است مدت بیشتری طول بکشد تا تصویب شود.
همه پروژه ها سهمیه یکسانی ندارند. از آنجایی که در طول زمان به طور فزاینده ای از Google Cloud استفاده می کنید، ممکن است نیاز باشد که سهمیه های شما افزایش یابد. اگر انتظار افزایش چشمگیر استفاده در آینده را دارید، می‌توانید به طور فعالانه از صفحه سهمیه‌ها در کنسول Google Cloud درخواست تنظیمات سهمیه کنید .
برای کسب اطلاعات بیشتر به منابع زیر مراجعه کنید:
- درباره درخواست های افزایش سهمیه
- میزان استفاده و محدودیت های فعلی خود را مشاهده کنید
- درخواست محدودیت سهمیه بالاتر