سهمیه‌ها از زیرساخت Google در برابر فرآیندهای خودکاری که از Campaign Manager 360 API به روشی نامناسب استفاده می‌کنند محافظت می‌کند. آنها اطمینان می دهند که اقدامات یک توسعه دهنده نمی تواند تأثیر منفی بر جامعه بزرگتر بگذارد.
محدودیت های سهمیه ای
محدودیت‌های سهمیه پیش‌فرض زیر توسط همه منابع و روش‌های Campaign Manager 360 API مشترک است.
- 50000 درخواست در هر پروژه در روز - قابل افزایش است .
- 1 پرس و جو در ثانیه (QPS) در هر پروژه.
- در Google API Console این سهمیه به عنوان Queries در دقیقه برای هر کاربر نامیده می شود و به طور پیش فرض روی 60 تنظیم شده است. این حد را می توان در صورت نیاز تا حداکثر 600 (10 QPS) افزایش داد.
Report Builder محدودیت های سهمیه اضافی را اعمال می کند که بسته به حساب متفاوت است. برای کسب اطلاعات بیشتر، به این مقاله مرکز راهنمایی و جدول زیر مراجعه کنید.
فراتر از حد نصاب
در صورتی که درخواست شما به دلیل فراتر رفتن از حد مجاز ناموفق باشد، API یک کد وضعیت HTTP و دلیل خطا را برمی‌گرداند. علاوه بر این، بدنه پاسخ حاوی شرح مفصلی از آنچه باعث خطا شده است. برای نمونه پاسخ خطا به راهنمای پیام های خطا مراجعه کنید.
لیست زیر خطاهای احتمالی و اقدامات توصیه شده برای شکست درخواست ناشی از فراتر از حد مجاز را نشان می دهد.
| کد | دلیل | پیام | اقدام توصیه شده |
|---|---|---|---|
| 403 | dailyLimitExceeded | از حد مجاز روزانه فراتر رفت | بدون رفع مشکل دوباره امتحان نکنید. استفاده خود را از Google API Console بررسی کنید و گردش کار خود را تغییر دهید تا درخواست های کمتری داشته باشید. اگر فکر می کنید استفاده شما منطقی است، می توانید سهمیه اضافی درخواست کنید . |
| 403 | سهمیه فراتر رفت | این حساب از سهمیه x گزارش خود در روز فراتر رفته است. | در این روز دیگر سعی نکنید گزارشی برای این حساب اجرا کنید. برای راهنمایی با مدیر حساب خود تماس بگیرید. |
| 403 | سهمیه فراتر رفت | این نمایه کاربر از سهمیه x گزارش خود در روز فراتر رفته است. | در این روز دیگر سعی نکنید گزارشی برای این نمایه کاربر اجرا کنید. به نمایه کاربری دیگری بروید یا برای راهنمایی با مدیر حساب خود تماس بگیرید. |
| 403 | سهمیه فراتر رفت | این حساب از سهمیه x گزارش برنامه‌ریزی‌شده فعال فراتر رفته است. | قبل از امتحان مجدد این درخواست، گزارش‌های برنامه‌ریزی‌شده‌ای را که به آنها نیاز ندارید، غیرفعال کنید. |
| 403 | سهمیه فراتر رفت | نمایه کاربری که مالک این گزارش است از سهمیه x گزارش برنامه‌ریزی‌شده فعال فراتر رفته است. | از صاحب این گزارش بخواهید گزارش‌های برنامه‌ریزی‌شده‌ای را که به آنها نیاز ندارند، قبل از امتحان مجدد این درخواست غیرفعال کند. |
| 403 | سهمیه فراتر رفت | این نمایه کاربر از سهمیه x گزارش برنامه‌ریزی‌شده فعال فراتر رفته است. | قبل از امتحان مجدد این درخواست، گزارش‌های برنامه‌ریزی‌شده‌ای را که به آنها نیاز ندارید، غیرفعال کنید. |
| 403 | سهمیه فراتر رفت | نمی‌توان این اقدام را تکمیل کرد زیرا از یکی از سهمیه‌های شما فراتر رفته است. لطفاً برای راهنمایی با مدیر حساب خود تماس بگیرید. | برای راهنمایی با مدیر حساب خود تماس بگیرید. |
| 403 | userRateLimitExceeded | از حد مجاز نرخ کاربر فراتر رفت | محدودیت هر کاربر را در Google API Console افزایش دهید یا سرعت ارسال درخواست‌ها را با استفاده از backoff نمایی کاهش دهید. توصیه نمی شود که درخواست نوشتن همزمان یا استفاده از محدودیت نرخ بالاتر از 10 QPS را با این API انجام دهید. |
درخواست سهمیه روزانه اضافی
اگر فکر می‌کنید که درخواست شما به سهمیه روزانه اضافی نیاز دارد، می‌توانید با دنبال کردن دستورالعمل‌های زیر بیشتر درخواست کنید.
دستورالعمل های زیر فقط برای پروژه هایی اعمال می شود که با خطای dailyLimitExceeded مواجه شده اند. اقدامات توصیه شده برای سایر خطاهای سهمیه در جدول بالا پوشش داده شده است.
- در Google API Console به Campaign Manager 360 API بروید.
- آمار استفاده خود را از صفحه Metrics مرور کنید تا مطمئن شوید برنامه شما مطابق انتظار عمل می کند. قبل از ادامه، به روش هایی که فراخوانی شده اند دقت کنید و هرگونه استفاده غیرمنتظره یا بیش از حد را برطرف کنید.
- اگر استفاده عادی به نظر می رسد، به صفحه سهمیه ها بروید، روی نماد ویرایش در کنار Queries per day کلیک کنید و روی پیوند "درخواست برای سهمیه بالاتر" کلیک کنید.
قبل از ارسال درخواست افزایش، حتماً اطلاعات را بررسی کرده و دستورالعمل‌های موجود در فرم درخواست سهمیه را دنبال کنید.
،سهمیه‌ها از زیرساخت Google در برابر فرآیندهای خودکاری که از Campaign Manager 360 API به روشی نامناسب استفاده می‌کنند محافظت می‌کند. آنها اطمینان می دهند که اقدامات یک توسعه دهنده نمی تواند تأثیر منفی بر جامعه بزرگتر بگذارد.
محدودیت های سهمیه ای
محدودیت‌های سهمیه پیش‌فرض زیر توسط همه منابع و روش‌های Campaign Manager 360 API مشترک است.
- 50000 درخواست در هر پروژه در روز - قابل افزایش است .
- 1 پرس و جو در ثانیه (QPS) در هر پروژه.
- در Google API Console این سهمیه به عنوان Queries در دقیقه برای هر کاربر نامیده می شود و به طور پیش فرض روی 60 تنظیم شده است. این حد را می توان در صورت نیاز تا حداکثر 600 (10 QPS) افزایش داد.
Report Builder محدودیت های سهمیه اضافی را اعمال می کند که بسته به حساب متفاوت است. برای کسب اطلاعات بیشتر، به این مقاله مرکز راهنمایی و جدول زیر مراجعه کنید.
فراتر از حد نصاب
در صورتی که درخواست شما به دلیل فراتر رفتن از حد مجاز ناموفق باشد، API یک کد وضعیت HTTP و دلیل خطا را برمی‌گرداند. علاوه بر این، بدنه پاسخ حاوی شرح مفصلی از آنچه باعث خطا شده است. برای نمونه پاسخ خطا به راهنمای پیام های خطا مراجعه کنید.
لیست زیر خطاهای احتمالی و اقدامات توصیه شده برای شکست درخواست ناشی از فراتر از حد مجاز را نشان می دهد.
| کد | دلیل | پیام | اقدام توصیه شده |
|---|---|---|---|
| 403 | dailyLimitExceeded | از حد مجاز روزانه فراتر رفت | بدون رفع مشکل دوباره امتحان نکنید. استفاده خود را از Google API Console بررسی کنید و گردش کار خود را تغییر دهید تا درخواست های کمتری داشته باشید. اگر فکر می کنید استفاده شما منطقی است، می توانید سهمیه اضافی درخواست کنید . |
| 403 | سهمیه فراتر رفت | این حساب از سهمیه x گزارش خود در روز فراتر رفته است. | در این روز دیگر سعی نکنید گزارشی برای این حساب اجرا کنید. برای راهنمایی با مدیر حساب خود تماس بگیرید. |
| 403 | سهمیه فراتر رفت | این نمایه کاربر از سهمیه x گزارش خود در روز فراتر رفته است. | در این روز دیگر سعی نکنید گزارشی برای این نمایه کاربر اجرا کنید. به نمایه کاربری دیگری بروید یا برای راهنمایی با مدیر حساب خود تماس بگیرید. |
| 403 | سهمیه فراتر رفت | این حساب از سهمیه x گزارش برنامه‌ریزی‌شده فعال فراتر رفته است. | قبل از امتحان مجدد این درخواست، گزارش‌های برنامه‌ریزی‌شده‌ای را که به آنها نیاز ندارید، غیرفعال کنید. |
| 403 | سهمیه فراتر رفت | نمایه کاربری که مالک این گزارش است از سهمیه x گزارش برنامه‌ریزی‌شده فعال فراتر رفته است. | از صاحب این گزارش بخواهید گزارش‌های برنامه‌ریزی‌شده‌ای را که به آنها نیاز ندارند، قبل از امتحان مجدد این درخواست غیرفعال کند. |
| 403 | سهمیه فراتر رفت | این نمایه کاربر از سهمیه x گزارش برنامه‌ریزی‌شده فعال فراتر رفته است. | قبل از امتحان مجدد این درخواست، گزارش‌های برنامه‌ریزی‌شده‌ای را که به آنها نیاز ندارید، غیرفعال کنید. |
| 403 | سهمیه فراتر رفت | نمی‌توان این اقدام را تکمیل کرد زیرا از یکی از سهمیه‌های شما فراتر رفته است. لطفاً برای راهنمایی با مدیر حساب خود تماس بگیرید. | برای راهنمایی با مدیر حساب خود تماس بگیرید. |
| 403 | userRateLimitExceeded | از حد مجاز نرخ کاربر فراتر رفت | محدودیت هر کاربر را در Google API Console افزایش دهید یا سرعت ارسال درخواست‌ها را با استفاده از backoff نمایی کاهش دهید. توصیه نمی شود که درخواست نوشتن همزمان یا استفاده از محدودیت نرخ بالاتر از 10 QPS را با این API انجام دهید. |
درخواست سهمیه روزانه اضافی
اگر فکر می‌کنید که درخواست شما به سهمیه روزانه اضافی نیاز دارد، می‌توانید با دنبال کردن دستورالعمل‌های زیر بیشتر درخواست کنید.
دستورالعمل های زیر فقط برای پروژه هایی اعمال می شود که با خطای dailyLimitExceeded مواجه شده اند. اقدامات توصیه شده برای سایر خطاهای سهمیه در جدول بالا پوشش داده شده است.
- در Google API Console به Campaign Manager 360 API بروید.
- آمار استفاده خود را از صفحه Metrics مرور کنید تا مطمئن شوید برنامه شما مطابق انتظار عمل می کند. قبل از ادامه، به روش هایی که فراخوانی شده اند دقت کنید و هرگونه استفاده غیرمنتظره یا بیش از حد را برطرف کنید.
- اگر استفاده عادی به نظر می رسد، به صفحه سهمیه ها بروید، روی نماد ویرایش در کنار Queries per day کلیک کنید و روی پیوند "درخواست برای سهمیه بالاتر" کلیک کنید.
قبل از ارسال درخواست افزایش، حتماً اطلاعات را بررسی کرده و دستورالعمل‌های موجود در فرم درخواست سهمیه را دنبال کنید.