سهمیه ها

سهمیه‌ها از زیرساخت Google در برابر فرآیندهای خودکاری که از Google Bid Manager API به روشی نامناسب استفاده می‌کنند محافظت می‌کند. آنها اطمینان می دهند که اقدامات یک توسعه دهنده نمی تواند تأثیر منفی بر جامعه بزرگتر بگذارد.

محدودیت های سهمیه

محدودیت‌های سهمیه پیش‌فرض زیر توسط همه منابع و روش‌های Bid Manager API مشترک است.

• 2000 درخواست در هر پروژه در روز - قابل افزایش است .
• 4 پرس و جو در ثانیه (QPS) در هر پروژه.
  • در Google API Console این سهمیه به عنوان Queries در دقیقه برای هر کاربر نامیده می شود و روی 240 تنظیم شده است.

توجه: سهمیه های روزانه در نیمه شب PST به روز می شوند.

فراتر از حد نصاب

در صورتی که درخواست شما به دلیل فراتر رفتن از حد مجاز ناموفق باشد، API یک کد وضعیت HTTP و دلیل خطا را برمی‌گرداند. علاوه بر این، بدنه پاسخ حاوی شرح مفصلی از آنچه باعث خطا شده است. برای نمونه پاسخ خطا به راهنمای پیام های خطا مراجعه کنید.

لیست زیر خطاهای احتمالی و اقدامات توصیه شده برای شکست درخواست ناشی از فراتر از حد مجاز را نشان می دهد.

کد	دلیل	پیام	عمل پیشنهاد شده
403	dailyLimitExceeded	از حد مجاز روزانه فراتر رفت	بدون رفع مشکل دوباره امتحان نکنید. استفاده خود را از Google API Console بررسی کنید و گردش کار خود را تغییر دهید تا درخواست های کمتری داشته باشید. اگر فکر می کنید استفاده شما منطقی است، می توانید سهمیه اضافی درخواست کنید .
403	userRateLimitExceeded	از حد مجاز نرخ کاربر فراتر رفت	سرعت ارسال درخواست ها را با استفاده از عقب نشینی نمایی کاهش دهید.

عقب نشینی نمایی چیست؟

عقب نشینی نمایی یک استراتژی استاندارد مدیریت خطا برای برنامه های کاربردی شبکه است که در آن کلاینت به طور دوره ای یک درخواست ناموفق را در مدت زمان فزاینده ای تکرار می کند. اگر حجم بالای درخواست‌ها یا ترافیک شبکه سنگین باعث شود سرور خطاها را برگرداند، پس‌انداز نمایی ممکن است استراتژی خوبی برای رسیدگی به این خطاها باشد. برعکس، این یک استراتژی مناسب برای برخورد با خطاهای غیرمرتبط با حجم شبکه یا زمان پاسخ، مانند اعتبارنامه های مجوز نامعتبر یا خطاهای یافت نشدن فایل نیست.

اگر به درستی استفاده شود، پس‌انداز نمایی کارایی استفاده از پهنای باند را افزایش می‌دهد، تعداد درخواست‌های مورد نیاز برای دریافت پاسخ موفقیت‌آمیز را کاهش می‌دهد و توان عملیاتی درخواست‌ها را در محیط‌های همزمان به حداکثر می‌رساند.

جریان برای پیاده سازی عقب نشینی نمایی ساده به شرح زیر است:

1. یک درخواست به API بدهید.
2. پاسخ HTTP 503 را دریافت کنید، که نشان می دهد باید درخواست را دوباره امتحان کنید.
3. 1 ثانیه + random_number_milliseconds صبر کنید و دوباره درخواست را امتحان کنید.
4. پاسخ HTTP 503 را دریافت کنید، که نشان می دهد باید درخواست را دوباره امتحان کنید.
5. 2 ثانیه + random_number_milliseconds صبر کنید و دوباره درخواست را امتحان کنید.
6. پاسخ HTTP 503 را دریافت کنید، که نشان می دهد باید درخواست را دوباره امتحان کنید.
7. 4 ثانیه + random_number_milliseconds صبر کنید و دوباره درخواست را امتحان کنید.
8. پاسخ HTTP 503 را دریافت کنید، که نشان می دهد باید درخواست را دوباره امتحان کنید.
9. ۸ ثانیه + random_number_milliseconds صبر کنید و دوباره درخواست را امتحان کنید.
10. پاسخ HTTP 503 را دریافت کنید، که نشان می دهد باید درخواست را دوباره امتحان کنید.
11. 16 ثانیه + random_number_milliseconds صبر کنید و دوباره درخواست را امتحان کنید.
12. متوقف کردن. یک خطا را گزارش یا ثبت کنید.

در جریان فوق، random_number_milliseconds تعداد تصادفی میلی‌ثانیه‌ها کمتر یا مساوی 1000 است. این امر ضروری است، زیرا وارد کردن یک تاخیر تصادفی کوچک به توزیع یکنواخت بار و جلوگیری از احتمال ضربه زدن به سرور کمک می‌کند. مقدار random_number_milliseconds باید بعد از هر انتظار دوباره تعریف شود.

توجه: انتظار همیشه (2 ^ n) + random_number_milliseconds است، که در آن n یک عدد صحیح افزایشی یکنواخت است که در ابتدا 0 تعریف شده است. عدد صحیح n برای هر تکرار (هر درخواست) 1 افزایش می یابد.

الگوریتم تنظیم شده است تا زمانی که n 5 باشد خاتمه یابد. این سقف مانع از تلاش مجدد مشتریان برای بی نهایت می شود و منجر به تأخیر کلی در حدود 32 ثانیه قبل از اینکه یک درخواست "خطایی غیرقابل جبران" تلقی شود، می شود. حداکثر تعداد بیشتری از تلاش های مجدد خوب است، به خصوص اگر یک آپلود طولانی در حال انجام باشد. فقط مطمئن شوید که تاخیر تلاش مجدد را در چیزی معقول، مثلاً کمتر از یک دقیقه محدود کنید.

درخواست سهمیه روزانه اضافی

اگر فکر می‌کنید که درخواست شما به سهمیه روزانه اضافی نیاز دارد، می‌توانید با دنبال کردن دستورالعمل‌های زیر بیشتر درخواست کنید.

دستورالعمل های زیر فقط برای پروژه هایی اعمال می شود که با خطای dailyLimitExceeded مواجه شده اند. اقدامات توصیه شده برای سایر خطاهای سهمیه در جدول بالا پوشش داده شده است.

1. به Bid Manager API در Google API Console بروید.
2. آمار استفاده خود را از صفحه Metrics مرور کنید تا مطمئن شوید برنامه شما مطابق انتظار عمل می کند. قبل از ادامه، به روش هایی که فراخوانی شده اند دقت کنید و هرگونه استفاده غیرمنتظره یا بیش از حد را برطرف کنید.
3. اگر استفاده عادی به نظر می رسد، به صفحه سهمیه ها بروید، روی نماد ویرایش در کنار Queries per day کلیک کنید و روی پیوند "درخواست برای سهمیه بالاتر" کلیک کنید.

قبل از ارسال درخواست افزایش، حتماً اطلاعات را بررسی کرده و دستورالعمل‌های موجود در فرم درخواست سهمیه را دنبال کنید.

توجه: آدرس ایمیلی که ارائه می‌کنید باید آدرسی باشد که شما فعالانه آن را نظارت می‌کنید، زیرا ممکن است نماینده برای جمع‌آوری اطلاعات بیشتر تماس بگیرد.