این سند محدودیت ها و سهمیه های درخواست API های مدیریت و API های گزارش را شرح می دهد.
گوگل آنالیتیکس توسط میلیون ها سایت استفاده می شود. ما محدودیتها و سهمیههایی را برای درخواستهای API در نظر میگیریم تا از سیستم در برابر دریافت دادههای بیشتر از توانش محافظت کنیم و از توزیع عادلانه منابع سیستم اطمینان حاصل کنیم. محدودیت ها و سهمیه ها در معرض تغییر هستند.
این ویدیو بهترین شیوههای مدیریت سهمیه درخواست Google Analytics API را مورد بحث قرار میدهد.
محدودیت های سهمیه عمومی
سهمیه های زیر برای مدیریت API , Core Reporting API v3 , MCF Reporting API , Metadata API , User Deletion API و Real Time Reporting API اعمال می شود :
- 50000 درخواست در هر پروژه در روز که قابل افزایش است .
- 10 پرس و جو در ثانیه (QPS) در هر آدرس IP .
- در کنسول API یک سهمیه مشابه به عنوان درخواست در هر 100 ثانیه برای هر کاربر وجود دارد. به طور پیش فرض، روی 100 درخواست در هر 100 ثانیه برای هر کاربر تنظیم شده است و می توان آن را تا حداکثر مقدار 1000 تنظیم کرد. اما تعداد درخواست ها به API به حداکثر 10 درخواست در ثانیه برای هر کاربر محدود شده است.
- اگر برنامه شما همه درخواستهای API را از یک آدرس IP (یعنی از طرف کاربران شما) انجام میدهد، از پارامتر
userIP
یاquotaUser
برای هر درخواست استفاده کنید تا سهمیه QPS کامل برای هر کاربر را دریافت کنید. برای جزئیات به خلاصه پارامترهای پرس و جو استاندارد مراجعه کنید.
APIهای گزارش
سهمیههای زیر برای همه APIهای Reporting اعمال میشود، از جمله Core Reporting API v3 ، Analytics Reporting API v4 ، Real Time API v3 و Multi-channel Funnel API v3 :
- 10000 درخواست در هر بازدید (نمایه) در روز (قابل افزایش نیست)
- 10 درخواست همزمان در هر نمایش (نمایه) (قابل افزایش نیست)
این رفتار رویکردی دقیقتر و ایمنتر برای مدیریت سهمیهها ارائه میکند، به طوری که تماسهای مکرر با استفاده از Analytics Real Time Reporting API بهطور تصادفی همه تماسهای دیگر Analytics API را در بقیه روز برای یک نمای فردی (نمایه) مسدود نمیکند.
گزارش خطاهای درخواست API
اگر درخواست شما برای Reporting API با خطای سرور انجام نشد، کد پاسخ 500
یا 503
دریافت می کنید. می توانید درخواست را دوباره ارسال کنید؛ با این حال، در صورت عدم موفقیت مجدد، بیش از یک بار این درخواست را دوباره ارسال نکنید. Google Analytics اجازه می دهد:
- 10 خطای سرور درخواست های ناموفق در هر پروژه در هر نمایش (نمایه) در ساعت
- 50 خطای سرور درخواست های ناموفق در هر پروژه در هر نمایش (نمایه) در روز
اگر تعداد درخواست های ناموفق شما از این سهمیه ها بیشتر شود، با خطای زیر مواجه می شوید:
Quota Error: The number of recent reporting API requests failing by server error is too high. You are temporarily blocked from the reporting API for at least an hour. Please send fewer server errors in the future to avoid being blocked.
برای کاهش احتمال خطای سرور درخواست، درخواست را با این موارد ساده کنید: کاهش محدوده تاریخ، کاهش تعداد ابعاد در درخواست، یا کاهش تعداد معیارهای درخواست.
درخواست ناموفق را به طور مداوم دوباره ارسال نکنید. در عوض، برای ارسال مجدد آن ، عقب نشینی نمایی را اجرا کنید .
سهمیههای نرخ خطای سرور در طول پنجرههای زمانی متحرک برای هر یک از سهمیههای میزان خطای ساعتی و روزانه اعمال میشوند. یک ساعت پس از پروژه و مشاهده اولین خطای سرور جفت، سهمیه بازنشانی می شود. اگر یک جفت پروژه و نمایش 10 خطای سرور را در یک ساعت ارسال کند، جفت پروژه و نمایش از API تا یک ساعت پس از سپری شدن اولین خطای سرور مسدود می شود.
به عنوان مثال اگر یک جفت پروژه و ویو در 24 ساعت گذشته خطای سرور ارسال نکرده باشد، این پروژه و نمای از 0 از 50 سهمیه خود استفاده کرده است. فرض کنید این پروژه و مشاهده اکنون یک خطای سرور را در ساعت 6:12 صبح ارسال کنید. اگر این پروژه و نمای 49 خطای سرور اضافی را قبل از ساعت 6:12 صبح روز بعد ارسال کند، این پروژه و مشاهده تا ساعت 6:12 صبح روز بعد مسدود خواهد شد. در ساعت 6:12 صبح روز بعد، سهمیه میزان خطای سرور برای این پروژه و مشاهده به طور کامل بازنشانی می شود.
فراتر از حد نصاب
اگر از سهمیه درخواست Google Analytics API فراتر رود، API کد خطای 403
یا 429
و پیامی مبنی بر اینکه حساب از سهمیه فراتر رفته است را برمیگرداند. برای اطلاعات بیشتر به شرایط خدمات مراجعه کنید.
درخواست سهمیه اضافی
فقط می توانید درخواست افزایش دهید:
- تعداد درخواست های خواندن روزانه در هر پروژه (50000 پیش فرض)
- تعداد درخواست نوشتن روزانه در هر پروژه (50 پیش فرض)
برای مشاهده یا تغییر محدودیتهای استفاده برای پروژه خود، یا درخواست افزایش سهمیه، موارد زیر را انجام دهید:
- اگر قبلاً یک حساب صورتحساب برای پروژه خود ندارید، آن را ایجاد کنید.
- از صفحه Enabled APIs کتابخانه API در کنسول API دیدن کنید و یک API را از لیست انتخاب کنید.
- برای مشاهده و تغییر تنظیمات مربوط به سهمیه، سهمیه ها را انتخاب کنید. برای مشاهده آمار استفاده، استفاده را انتخاب کنید.
برای درخواست افزایش حداکثر مقدار سهمیه، لطفاً از فرم درخواست سهمیه Analytics API استفاده کنید. قبل از ارسال درخواست، حتماً اطلاعات را بررسی کرده و دستورالعملهای موجود در فرم درخواست سهمیه را دنبال کنید. برای Reporting API v4، نام API در Google API Console، Google Analytics Reporting API است. همه APIهای v3 دیگر (به عنوان مثال، مدیریت API v3، Core Reporting API v3، Real Time Reporting API v3، User Deletion API v3) در زیر Analytics API در Google API Console فهرست شدهاند.
برای اطلاعات بیشتر در مورد مدیریت سهمیه و نحوه تنظیم دقیق برنامه خود برای استفاده از سهمیه، به نظارت بر APIها و استفاده محدود مراجعه کنید.