محدودیت‌ها و سهمیه‌ها از زیرساخت Google در برابر فرآیند خودکاری محافظت می‌کنند که از API تنظیمات گروه‌ها به روشی نامناسب استفاده می‌کند. درخواست‌های بیش از حد از یک API ممکن است ناشی از یک اشتباه تایپی بی‌ضرر یا یک سیستم طراحی ناکارآمد باشد که تماس‌های API بی‌ضروری را ایجاد می‌کند. صرف نظر از علت، مسدود کردن ترافیک از یک منبع خاص پس از رسیدن به سطح مشخصی برای سلامت کلی سیستم Google Workspace ضروری است.
شکست درخواست API
در صورتی که درخواست API شما ناموفق باشد، برنامه شما پاسخ کد وضعیت HTTP را دریافت می کند. کد وضعیت HTTP 403 دارای اطلاعات خطایی است که نشان می دهد از سهمیه های API فراتر رفته است. پاسخ به برنامه سفارشی شما امکان می دهد خطاها را شناسایی کرده و اقدامات مناسب را انجام دهد.
درخواست های حساس به زمان
اگر درخواست‌های شما باید در یک بازه زمانی مشخص تکمیل شوند، درخواست‌های خود را به صورت موازی ارسال کنید یا از چندین رشته در برنامه جاوا یا سی شارپ خود استفاده کنید. به عنوان مثال، درخواست های خود را بر اساس ماه یا دوره زمانی دیگر بشکنید. در مورد رشته ها، سعی کنید با 10 رشته شروع کنید، هر درخواست یک رشته. توصیه رشته دارای معاوضه هایی است و برای همه موقعیت های API مفید نیست. اگر تعداد درخواست ها خیلی زیاد شود، خطاهای سهمیه ای رخ می دهد.
خطاهای مبتنی بر زمان
برای همه خطاهایی که مبتنی بر زمان هستند (حداکثر N چیز برای X ثانیه در هر رشته)، به خصوص خطاهای کد وضعیت 503 ، توصیه می کنیم کد شما استثنا را بگیرد و با استفاده از یک الگوریتم عقب نشینی نمایی ، قبل از تلاش مجدد، کمی تأخیر صبر کنید. تماس ناموفق نمونه API تنظیمات گروه ها برای یک رشته این است که 5 ثانیه صبر کنید و تماس ناموفق را دوباره امتحان کنید. اگر درخواست موفقیت آمیز بود، این الگو را برای رشته های دیگر تکرار کنید. اگر درخواست دوم موفقیت آمیز نباشد، برنامه شما باید فرکانس درخواست را کاهش دهد تا زمانی که تماس موفقیت آمیز باشد. به عنوان مثال، 5 ثانیه تاخیر اولیه را به 10 ثانیه افزایش دهید و دوباره تماس ناموفق خود را دوباره امتحان کنید. همچنین، در مورد محدودیت تلاش مجدد تصمیم بگیرید. به عنوان مثال، قبل از اینکه برنامه شما خطایی را به کاربر بازگرداند، یک درخواست را 5 تا 7 بار با زمان‌های تاخیر متفاوت امتحان کنید.
سهمیه ها
| دسته های سهمیه API | سهمیه ها |
|---|---|
| پرس و جو در روز | شما می توانید تا 100000 درخواست در روز بپرسید. اگر به ظرفیت فراتر از این حد نیاز دارید، می‌توانید از صفحه سهمیه‌ها در کنسول Google Cloud درخواست ارسال کنید |
| توضیحات گروه، حداکثر اندازه | شما می توانید یک توضیح گروهی تا 4096 کاراکتر وارد کنید. |
| نام گروه، حداکثر اندازه | نام یک گروه می تواند حداکثر 60 کاراکتر داشته باشد. |
defaultMessageDenyNotificationText | متن اعلان می تواند حداکثر 10000 کاراکتر باشد. برای کسب اطلاعات بیشتر در مورد ویژگی defaultMessageDenyNotificationText ، به مرجع API مراجعه کنید. |
maxMessageBytes | حداکثر اندازه پیام پیش فرض 1 مگابایت است. برای کسب اطلاعات بیشتر در مورد ویژگی maxMessageBytes ، به مرجع API مراجعه کنید. |
محدودیت ها
| انواع محدودیت ها | محدودیت ها و دستورالعمل ها |
|---|---|
| فرمت داده، پیش فرض | فرمت پیش فرض داده JSON است. API از فرمت Atom نیز پشتیبانی می کند. هر دو فرمت داده JSON و Atom از قابلیت خواندن و نوشتن کامل پشتیبانی می کنند. برای اطلاعات بیشتر، فرمت‌های داده JSON و Atom را ببینید. |
| API تنظیمات گروه ها، فعال کردن | قبل از برقراری تماس با Groups Settings API، باید Directory API را روشن کنید. برای اطلاعات بیشتر، به فعال کردن Google Workspace APIs مراجعه کنید. |