محدودیتها و سهمیهها، زیرساخت گوگل را از فرآیندهای خودکاری که از API Reseller به طور نامناسب استفاده میکنند، محافظت میکنند. درخواستهای بیش از حد ممکن است ناشی از اشتباه تایپی یا طراحی ناکارآمد سیستم باشد. برای کمک به اطمینان از سلامت سیستم Google Workspace، گوگل ترافیک را از منابع خاص هنگامی که به سطوح خاصی میرسد، مسدود میکند. این امر تضمین میکند که اقدامات یک توسعهدهنده تأثیر منفی بر جامعه نگذارد.
شکست درخواستهای API
اگر درخواست API با شکست مواجه شود، برنامه شما یک کد وضعیت HTTP دریافت میکند. کد وضعیت 403 نشاندهنده ورودی نادرست است و کد وضعیت 503 نشان میدهد که سهمیه API از حد مجاز فراتر رفته است. از این پاسخها برای تشخیص خطاها و انجام اقدامات لازم استفاده کنید.
خطاهای مبتنی بر زمان
برای خطاهای مبتنی بر زمان، به ویژه کدهای وضعیت 503 ، از یک الگوریتم بازگشت نمایی استفاده کنید. قبل از تلاش مجدد برای فراخوانی ناموفق، کمی تأخیر صبر کنید. به عنوان مثال، ۵ ثانیه صبر کنید و دوباره امتحان کنید. در صورت موفقیت، این الگو را برای سایر نخها تکرار کنید. اگر درخواست دوم ناموفق بود، تعداد درخواستها را تا زمان موفقیتآمیز بودن یک فراخوانی کاهش دهید. تعیین محدودیت تلاش مجدد، مانند ۵ تا ۷ بار، نیز توصیه میشود.
محدودیتها
| دسته بندی های محدود API | محدودیتها |
|---|---|
شناسه purchaseOrderId اشتراک | این ویژگی تا ۸۰ کاراکتر متن ساده را میپذیرد. |
maxResults نتایج اشتراک | رشته کوئری maxResults میتواند شامل ۱ تا ۱۰۰ نتیجه باشد. مقدار پیشفرض ۲۰ نتیجه است. |
توکن انتقال ( customerAuthToken ) | توکن انتقال مشتری به مدت 30 روز پس از تولید اعتبار دارد. |
| حداکثر تعداد کاربران برای یک مشتری | بسته به قرارداد شما، حداکثر تعداد کاربران میتواند ۵۰،۰۰۰ یا حداکثر تعریف شده در قرارداد نمایندگی فروش شما باشد. |
| درخواستهای غیرمجاز | گوگل درخواستهای غیرمجاز به رابط برنامهنویسی کاربردی فروشندگان (Reseller API) را مجاز نمیداند. اگر هیچ توکن مجوزی ارائه نشود، درخواست غیرمجاز تلقی میشود. برای اطلاعات بیشتر، به بخش «درباره احراز هویت و مجوز بیشتر بدانید» مراجعه کنید. |
انواع دیگر محدودیتها
| انواع دیگر محدودیتها | محدودیتها و دستورالعملها |
|---|---|
| قالب داده | قالب داده، نمادگذاری شیء جاوا اسکریپت ( JSON ) است. JSON یک فرمت اینترنتی رایج برای نمایش ساختارهای داده دلخواه است. این یک فرمت متنی مستقل از زبان است که از قراردادهای آشنا برای برنامهنویسان خانواده زبانهای C، از جمله C، C++، C#، Java، JavaScript، Perl و Python استفاده میکند. |
| قالب زمان | تاریخها و زمانها از مبدل Epoch به میلیثانیه استفاده میکنند. این قالب برای زمان ایجاد اشتراک، زمان شروع و پایان تعهد طرح و زمان پایان دوره آزمایشی رایگان اعمال میشود. |