سهمیه و مصرف
سهمیه، تعداد جستوجوهای مجاز در دورهٔ پلن شماست. محدودیت نرخ، تعداد مجاز در یک بازهٔ کوتاه را مشخص میکند. این دو محدودیت جدا هستند.
مصرف چطور محاسبه میشود؟
هر IP در درخواست جستوجو یک واحد مصرف دارد. جستوجوی تکی یک واحد و درخواست گروهی با ۲۰ ورودی، ۲۰ واحد مصرف میکند. IP تکراری هم یک ورودی جدا حساب میشود.
نتیجهٔ found: false نیز یک جستوجوی انجامشده است و مصرف دارد. درخواستی که به دلیل کمبود سهمیه یا عبور از محدودیت نرخ رد شود، بخشی از سهمیه را مصرف نمیکند.
باقیماندهٔ سهمیه را کجا ببینم؟
در بخش مصرف داشبورد، میزان مصرف و در بخش پلن و صورتحساب، اطلاعات پلن فعال را بررسی کنید. سقف جستوجوی گروهی و محدودیت نرخ به پلن بستگی دارند؛ پلنها در صفحهٔ قیمتگذاری قابل مقایسهاند.
پاسخ موفق جستوجو، سربرگهای زیر را هم برای برنامهٔ شما ارسال میکند:
| سربرگ | کاربرد |
|---|---|
X-RateLimit-Limit | سقف واحدهای مجاز در بازهٔ کوتاه |
X-RateLimit-Remaining | واحدهای باقیمانده در همان بازه |
X-RateLimit-Reset | زمان باقیمانده تا بازنشانی محدودیت نرخ، به ثانیه |
X-Quota-Limit | سقف سهمیهٔ دوره، اگر پلن سقف مشخص داشته باشد |
X-Quota-Used | واحدهای مصرفشدهٔ دوره |
X-Quota-Remaining | واحدهای باقیمانده، اگر پلن سقف مشخص داشته باشد |
X-Quota-Reset | زمان باقیمانده تا پایان دوره، به ثانیه |
وقتی به محدودیت میرسم چه کنم؟
هر دو حالت زیر با وضعیت 429 برمیگردند. برای تصمیم درست، فیلد error.code را بررسی کنید:
rate_limit_exceeded: سرعت ارسال را کاهش دهید و پس از فاصلهٔ زمانی دوباره تلاش کنید. افزایش تعداد تلاشهای همزمان کمکی نمیکند.quota_exceeded: سهمیهٔ دوره تمام شده است. تا دورهٔ بعد صبر کنید یا پلن خود را در داشبورد تغییر دهید؛ تکرار فوری همان درخواست نتیجه را عوض نمیکند.