محدودیت‌ها و سهمیه‌ها از زیرساخت Google در برابر فرآیند خودکاری محافظت می‌کنند که از API تنظیمات مدیریت به روشی نامناسب استفاده می‌کند. درخواست‌های بیش از حد از یک API ممکن است ناشی از یک اشتباه تایپی بی‌ضرر باشد، یا ممکن است ناشی از طراحی ناکارآمد سیستمی باشد که تماس‌های API بی‌ضروری را ایجاد می‌کند. صرف نظر از علت، مسدود کردن ترافیک از یک منبع خاص پس از رسیدن به سطح مشخصی برای سلامت کلی سیستم Google Workspace ضروری است. این تضمین می کند که اقدامات یک توسعه دهنده نمی تواند تأثیر منفی بر جامعه بزرگتر بگذارد.
در صورتی که درخواست API شما ناموفق باشد، پاسخ کد وضعیت HTTP را دریافت خواهید کرد. کد وضعیت 403 دارای اطلاعات خطا در مورد ورودی نادرست است و کد وضعیت HTTP 503 دارای اطلاعات خطایی است که نشان می دهد از سهمیه های API فراتر رفته است. این پاسخ ها به برنامه سفارشی شما اجازه می دهد تا این خطاها را شناسایی کرده و اقدامات مناسب را انجام دهد.
اگر درخواست‌های شما باید در یک بازه زمانی مشخص تکمیل شوند، درخواست‌های خود را به صورت موازی ارسال کنید یا از چندین رشته در برنامه جاوا یا سی شارپ خود استفاده کنید. به عنوان مثال، درخواست های خود را بر اساس ماه یا دوره زمانی دیگر بشکنید. در مورد رشته ها، سعی کنید با 10 رشته شروع کنید، هر درخواست یک رشته. توجه داشته باشید، توصیه رشته دارای معاوضه هایی است و برای همه موقعیت های API مفید نیست. اگر تعداد درخواست ها خیلی زیاد شود، خطاهای سهمیه ای رخ می دهد.
برای همه خطاهایی که مبتنی بر زمان هستند (حداکثر N چیز برای X ثانیه در هر رشته)، به خصوص خطاهای کد وضعیت 503، توصیه می کنیم کد شما استثنا را بگیرد و با استفاده از یک الگوریتم عقب نشینی نمایی ، قبل از امتحان مجدد خطای ناموفق، کمی تأخیر صبر کنید. زنگ زدن. یک مثال API تنظیمات ایمیل برای یک رشته این است که 5 ثانیه صبر کنید و تماس ناموفق را دوباره امتحان کنید. اگر درخواست موفقیت آمیز بود، این الگو را برای رشته های دیگر تکرار کنید. اگر درخواست دوم موفقیت آمیز نبود، برنامه شما باید تعداد دفعات درخواست را کاهش دهد تا زمانی که تماس موفقیت آمیز باشد. به عنوان مثال، 5 ثانیه تاخیر اولیه را به 10 ثانیه افزایش دهید و دوباره تماس ناموفق خود را دوباره امتحان کنید. همچنین، در مورد محدودیت تلاش مجدد تصمیم بگیرید. به عنوان مثال، قبل از اینکه برنامه شما خطایی را به کاربر بازگرداند، یک درخواست را 5 تا 7 بار با زمان‌های تاخیر متفاوت امتحان کنید.
| دسته بندی های سهمیه API | سهمیه ها |
|---|---|
| نشانه های احراز هویت ClientLogin | 24 ساعت اعتبار دارد. خطای '401 توکن منقضی شده' است. |
| تولید کلیدهای عمومی و خصوصی | با ارائه دهنده هویت خود، مجموعه ای از کلیدهای عمومی و خصوصی را با استفاده از الگوریتم های DSA یا RSA ایجاد کنید. کلید عمومی در گواهی فرمت X.509 است. برای اطلاعات بیشتر درباره کلیدهای امضای Single Sign-On مبتنی بر SAML، به ایجاد کلیدها و گواهینامه‌ها برای سرویس Google Workspace Single Sign-On مراجعه کنید. |
| لوگو | فایل تصویر لوگوی یک حساب کاربری می تواند در قالب JPEG، PNG یا GIF باشد. اندازه پیشنهادی 143 در 59 پیکسل است و فایل باید کوچکتر از 20 کیلوبایت باشد. هنگام استفاده از نشان‌واره‌های سفارشی، به یاد داشته باشید که از شرایط خدمات Google استفاده نکنید. و از استفاده از لوگوی گوگل، لوگوی جیمیل یا هر لوگوی دیگر گوگل خودداری کنید. برای اطلاعات بیشتر، آرم و خط‌مشی‌های صفحه فرود را ببینید . |
| ssoWhitelist | ssoWhitelist یک آدرس IP ماسک شبکه در قالب مسیریابی بین دامنه‌ای بدون کلاس (CIDR) است. |
| انواع دیگر محدودیت ها | محدودیت ها و دستورالعمل ها |
|---|---|
| وضعیت تأیید رکورد MX | وضعیت پیش‌فرض راستی‌آزمایی رکورد MX «نادرست» است که به این معنی است که یا سیستم Google اخیراً پیکربندی رکورد MX شما را بررسی نکرده است یا رکوردهای MX شما برای اشاره به سیستم‌های Google پیکربندی نشده‌اند. اگر سوابق خود را به‌روزرسانی کرده‌اید و وضعیت تأیید نادرست باقی می‌ماند، می‌تواند به این معنی باشد که به‌روزرسانی‌های رکورد MX شما منتشر نشده است یا اشتباه تایپی در رکورد وجود دارد. برای انتشار، توصیه می کنیم مدت زمان تعیین شده توسط رکورد MX Time To Live (TTL) صبر کنید و دوباره امتحان کنید. |
| کدهای کشور | اگر نام سازمان سفارشی نشده باشد، پیش فرض نام دامنه اصلی شما است. برای اطلاعات در مورد نویسه‌های نام سازمان، استفاده از نویسه را ببینید. |
ویژگی creationTime ، نمایش عددی تاریخ و زمان | ISO 8601 ، نمایش عددی تاریخ و زمان را ببینید. |
| برچسب های کدگذاری زبان | برچسب‌های زبان RFC 3066 که توسط Google Mail پذیرفته شده است را ببینید. |
| نام سازمان | اگر نام سازمان سفارشی نشده باشد، پیش فرض نام دامنه اصلی شما است. برای اطلاعات در مورد نویسه‌های نام سازمان، استفاده از نویسه را ببینید. |