سهمیهها از زیرساخت گوگل در برابر فرآیندهای خودکاری که از API کمپین منیجر ۳۶۰ به شیوهای نامناسب استفاده میکنند، محافظت میکنند. آنها تضمین میکنند که اقدامات یک توسعهدهنده نمیتواند تأثیر منفی بر جامعه بزرگتر داشته باشد.
محدودیتهای سهمیه
محدودیتهای سهمیه پیشفرض زیر بین همه منابع و روشهای API کمپین منیجر ۳۶۰ مشترک است.
- ۵۰،۰۰۰ درخواست برای هر پروژه در روز - قابل افزایش است .
- ۱ پرسوجو در ثانیه (QPS) برای هر پروژه.
- در کنسول API گوگل، این سهمیه با عنوان Queries per minute per user مشخص میشود و به طور پیشفرض روی ۶۰ تنظیم شده است. این محدودیت میتواند در صورت نیاز تا حداکثر ۶۰۰ (۱۰ QPS) افزایش یابد.
گزارشساز محدودیتهای سهمیه اضافی را اعمال میکند که بسته به حساب کاربری متفاوت است. برای کسب اطلاعات بیشتر، به این مقاله مرکز راهنما و جدول زیر مراجعه کنید.
تجاوز از محدودیت سهمیه
در صورت بعید که درخواست شما به دلیل عبور از حد سهمیه با شکست مواجه شود، API یک کد وضعیت HTTP و دلیل خطا را برمیگرداند. علاوه بر این، بدنه پاسخ شامل شرح مفصلی از علت خطا است. برای مشاهده یک نمونه پاسخ خطا، به راهنمای پیامهای خطا مراجعه کنید.
لیست زیر خطاهای احتمالی و اقدامات توصیه شده برای رفع خطاهای درخواست ناشی از تجاوز از محدودیت سهمیه را نشان میدهد.
| کد | دلیل | پیام | اقدام توصیه شده |
|---|---|---|---|
| ۴۰۳ | محدودیت روزانهتجاوز شده | از حد مجاز روزانه تجاوز شد | بدون رفع مشکل دوباره امتحان نکنید. میزان مصرف خود را از کنسول API گوگل بررسی کنید و گردش کار خود را اصلاح کنید تا درخواستهای کمتری داشته باشید. اگر فکر میکنید میزان مصرف شما منطقی است، میتوانید سهمیه اضافی درخواست کنید . |
| ۴۰۳ | سهمیه تجاوز شد | این حساب از سهمیه x گزارش در روز خود فراتر رفته است. | در این روز سعی نکنید گزارشهای بیشتری برای این حساب کاربری اجرا کنید. برای راهنمایی با مدیر حساب خود تماس بگیرید. |
| ۴۰۳ | سهمیه تجاوز شد | این نمایه کاربری از سهمیه x گزارش در روز خود فراتر رفته است. | در این روز سعی نکنید گزارشهای بیشتری برای این پروفایل کاربری اجرا کنید. برای کمک به یک پروفایل کاربری دیگر بروید یا با مدیر حساب خود تماس بگیرید. |
| ۴۰۳ | سهمیه تجاوز شد | این حساب از سهمیه x گزارش فعال زمانبندیشده خود فراتر رفته است. | قبل از تلاش مجدد برای این درخواست، گزارشهای زمانبندیشدهای را که نیازی ندارید غیرفعال کنید. |
| ۴۰۳ | سهمیه تجاوز شد | نمایه کاربری که مالک این گزارش است، از سهمیه x گزارش برنامهریزیشده فعال خود فراتر رفته است. | از صاحب این گزارش بخواهید گزارشهای زمانبندیشدهای را که به آنها نیاز ندارد، قبل از تلاش مجدد برای این درخواست غیرفعال کند. |
| ۴۰۳ | سهمیه تجاوز شد | این نمایه کاربری از سهمیه x گزارش فعال زمانبندیشده خود فراتر رفته است. | قبل از تلاش مجدد برای این درخواست، گزارشهای زمانبندیشدهای را که نیازی ندارید غیرفعال کنید. |
| ۴۰۳ | سهمیه تجاوز شد | به دلیل تکمیل یکی از سهمیههای شما، این اقدام امکانپذیر نیست. لطفاً برای راهنمایی با مدیر حساب خود تماس بگیرید. | برای کمک با مدیر حساب خود تماس بگیرید. |
| ۴۰۳ | userRateLimitExceeded | محدودیت نرخ کاربر از حد مجاز فراتر رفت | محدودیت هر کاربر را در کنسول API گوگل افزایش دهید یا سرعت ارسال درخواستها را با استفاده از backoff نمایی کاهش دهید. توصیه نمیشود که درخواستهای نوشتن همزمان ایجاد کنید یا محدودیت سرعتی بالاتر از 10 QPS را با این API به کار ببرید. |
درخواست سهمیه روزانه اضافی
اگر فکر میکنید درخواست شما به سهمیه روزانه بیشتری نیاز دارد، میتوانید با دنبال کردن دستورالعملهای زیر درخواست بیشتری کنید.
دستورالعملهای زیر فقط برای پروژههایی اعمال میشود که با خطای dailyLimitExceeded مواجه شدهاند. اقدامات توصیهشده برای سایر خطاهای سهمیهبندی در جدول بالا آمده است.
- در کنسول API گوگل، به رابط برنامهنویسی کاربردی مدیریت کمپین ۳۶۰ بروید.
- آمار استفاده خود را از صفحه معیارها بررسی کنید تا مطمئن شوید که برنامه شما مطابق انتظار عمل میکند. به متدهایی که فراخوانی شدهاند توجه دقیق داشته باشید و قبل از ادامه، هرگونه استفاده غیرمنتظره یا بیش از حد را برطرف کنید.
- اگر میزان مصرف طبیعی به نظر میرسد، به صفحه سهمیهها بروید، روی نماد ویرایش در کنار تعداد درخواستها در روز کلیک کنید و روی پیوند «درخواست سهمیه بالاتر» کلیک کنید.
قبل از ارسال درخواست افزایش سهمیه، حتماً اطلاعات را بررسی کرده و دستورالعملهای مندرج در فرم درخواست سهمیه را دنبال کنید.