محدودیتها و سهمیهها، زیرساخت گوگل را از یک فرآیند خودکار که از API تنظیمات مدیریت به شیوهای نامناسب استفاده میکند، محافظت میکنند. درخواستهای بیش از حد از یک API ممکن است ناشی از یک اشتباه تایپی بیضرر باشد، یا ممکن است ناشی از یک سیستم با طراحی ناکارآمد باشد که فراخوانیهای API غیرضروری انجام میدهد. صرف نظر از علت، مسدود کردن ترافیک از یک منبع خاص پس از رسیدن به سطح خاصی، برای سلامت کلی سیستم Google Workspace ضروری است. این تضمین میکند که اقدامات یک توسعهدهنده نمیتواند بر جامعه بزرگتر تأثیر منفی بگذارد.
در صورت عدم موفقیت درخواست API شما، که بعید به نظر میرسد، یک پاسخ با کد وضعیت HTTP دریافت خواهید کرد. کد وضعیت ۴۰۳ حاوی اطلاعات خطایی در مورد ورودی نادرست است و کد وضعیت HTTP ۵۰۳ حاوی اطلاعات خطایی است که نشان میدهد کدام سهمیههای API از حد مجاز فراتر رفتهاند. این پاسخها به برنامه سفارشی شما اجازه میدهند تا این خطاها را تشخیص داده و اقدامات مناسب را انجام دهد.
اگر درخواستهای شما باید در یک بازه زمانی مشخص تکمیل شوند، درخواستهای خود را به صورت موازی ارسال کنید یا از چندین thread در برنامه جاوا یا سیشارپ خود استفاده کنید. به عنوان مثال، درخواستهای خود را بر اساس ماه یا دوره زمانی دیگر تقسیمبندی کنید. در مورد threadها، سعی کنید با 10 thread شروع کنید، یک thread برای هر درخواست. توجه داشته باشید، توصیه thread دارای معایبی است و برای همه موقعیتهای API مفید نیست. اگر تعداد درخواستها خیلی زیاد شود، خطاهای سهمیهبندی رخ میدهد.
برای همه خطاهایی که مبتنی بر زمان هستند (حداکثر N مورد برای X ثانیه در هر نخ)، به خصوص خطاهای کد وضعیت 503، توصیه میکنیم کد شما استثنا را دریافت کند و با استفاده از یک الگوریتم بازگشت نمایی ، قبل از تلاش مجدد برای فراخوانی ناموفق، کمی تأخیر داشته باشد. یک مثال API تنظیمات ایمیل برای یک نخ، 5 ثانیه صبر کردن و تلاش مجدد برای فراخوانی ناموفق است. اگر درخواست موفقیتآمیز بود، این الگو را برای نخهای دیگر تکرار کنید. اگر درخواست دوم موفقیتآمیز نبود، برنامه شما باید فرکانس درخواست را تا زمانی که یک فراخوانی موفقیتآمیز باشد، کاهش دهد. به عنوان مثال، تأخیر 5 ثانیهای اولیه را به 10 ثانیه افزایش دهید و دوباره فراخوانی ناموفق خود را امتحان کنید. همچنین، در مورد محدودیت تلاش مجدد تصمیم بگیرید. به عنوان مثال، یک درخواست را 5 تا 7 بار با زمانهای تأخیر مختلف دوباره امتحان کنید تا اینکه برنامه شما خطایی را به کاربر برگرداند.
| دسته بندی سهمیه API | سهمیهها |
|---|---|
| توکنهای احراز هویت ClientLogin | به مدت ۲۴ ساعت معتبر است. خطا «۴۰۱ توکن منقضی شده است» است. |
| تولید کلیدهای عمومی و خصوصی | با ارائه دهنده هویت خود، مجموعهای از کلیدهای عمومی و خصوصی را با استفاده از الگوریتمهای DSA یا RSA ایجاد کنید. کلید عمومی در گواهی با فرمت X.509 است. برای اطلاعات بیشتر در مورد کلیدهای امضای ورود یکپارچه مبتنی بر SAML، به بخش «ایجاد کلیدها و گواهیها برای سرویس ورود یکپارچه Google Workspace» مراجعه کنید. |
| لوگو | فایل تصویر لوگوی یک حساب کاربری میتواند در قالب JPEG، PNG یا GIF باشد. اندازه توصیه شده ۱۴۳ در ۵۹ پیکسل است و فایل باید کوچکتر از ۲۰ کیلوبایت باشد. هنگام استفاده از لوگوهای سفارشی، به یاد داشته باشید که در چارچوب شرایط خدمات گوگل باقی بمانید. و از استفاده از لوگوی گوگل، لوگوی جیمیل یا هر لوگوی دیگر گوگل خودداری کنید. برای اطلاعات بیشتر، به سیاستهای لوگو و صفحه فرود مراجعه کنید. |
| لیست سفید sso | یک ssoWhitelist یک آدرس IP ماسک شبکه در قالب مسیریابی بین دامنهای بدون کلاس (CIDR) است. |
| انواع دیگر محدودیتها | محدودیتها و دستورالعملها |
|---|---|
| وضعیت تأیید رکورد MX | وضعیت پیشفرض تأیید رکورد MX، «نادرست» است، به این معنی که یا سیستم گوگل اخیراً پیکربندی رکورد MX شما را بررسی نکرده است یا رکوردهای MX شما برای اشاره به سیستمهای گوگل پیکربندی نشدهاند. اگر رکوردهای خود را بهروزرسانی کردهاید و وضعیت تأیید همچنان نادرست است، میتواند به این معنی باشد که بهروزرسانیهای رکورد MX شما منتشر نشدهاند، یا یک اشتباه تایپی در رکورد وجود دارد. برای انتشار، توصیه میکنیم به مدت زمان تعریفشده توسط مقدار زمان زنده ماندن (TTL) رکورد MX صبر کنید و دوباره امتحان کنید. |
| کدهای کشور | اگر نام سازمان سفارشیسازی نشده باشد، پیشفرض نام دامنه اصلی شما است. برای اطلاعات بیشتر در مورد کاراکترهای نام سازمان، به کاربرد کاراکترها مراجعه کنید. |
ویژگی creationTime ، نمایش عددی تاریخ و زمان | به استاندارد ISO 8601 ، نمایش عددی تاریخ و زمان، مراجعه کنید. |
| برچسبهای کدگذاری زبان | به برچسبهای زبانی RFC 3066 که توسط Google Mail پذیرفته شدهاند، مراجعه کنید. |
| نام سازمان | اگر نام سازمان سفارشیسازی نشده باشد، پیشفرض نام دامنه اصلی شما است. برای اطلاعات بیشتر در مورد کاراکترهای نام سازمان، به کاربرد کاراکترها مراجعه کنید. |
درخواست افزایش سهمیه هر پروژه
بسته به میزان استفاده از منابع پروژهتان، ممکن است بخواهید درخواست تنظیم سهمیه بدهید. فراخوانیهای API توسط یک حساب کاربری سرویس، به عنوان استفاده از یک حساب کاربری واحد در نظر گرفته میشوند. درخواست برای سهمیه تنظیمشده، تضمینی برای تأیید نیست. درخواستهای تنظیم سهمیه که مقدار سهمیه را به میزان قابل توجهی افزایش میدهند، ممکن است مدت زمان بیشتری طول بکشد تا تأیید شوند.
همه پروژهها سهمیههای یکسانی ندارند. با گذشت زمان و افزایش استفاده از گوگل کلود، ممکن است لازم باشد مقادیر سهمیه شما افزایش یابد. اگر انتظار افزایش قابل توجه استفاده در آینده را دارید، میتوانید به صورت پیشگیرانه از صفحه سهمیهها در کنسول گوگل کلود، درخواست تنظیم سهمیه کنید .
برای مطالعه بیشتر، به منابع زیر مراجعه کنید:
- درباره تعدیل سهمیهها
- مشاهده میزان استفاده و محدودیتهای سهمیه فعلی شما
- درخواست محدودیت سهمیه بالاتر