محدودیت ها و سهمیه های درخواست های API

برای اطمینان از اینکه سیستم گوگل آنالیتیکس داده های بیشتری از توان خود دریافت نمی کند و برای اطمینان از توزیع عادلانه منابع سیستم در بین کاربران، API های Google Analytics برخی محدودیت ها و سهمیه هایی را برای استفاده شما اعمال می کنند.

محدودیت‌ها و سهمیه‌های زیر برای استفاده کلی Google Analytics API شما (به استثنای تماس‌های Data API) در سطح پروژه Google Cloud اعمال می‌شود:

  • 50000 درخواست در هر پروژه در روز.
  • 10 پرس و جو در ثانیه (QPS) در هر آدرس IP .
    • در کنسول API یک سهمیه مشابه به عنوان درخواست در هر 100 ثانیه برای هر کاربر وجود دارد. به طور پیش فرض، روی 100 درخواست در هر 100 ثانیه برای هر کاربر تنظیم شده است و می توان آن را تا حداکثر مقدار 1000 تنظیم کرد. اما تعداد درخواست ها به API به حداکثر 10 درخواست در ثانیه برای هر کاربر محدود شده است.
    • اگر برنامه شما همه درخواست‌های API را از یک آدرس IP (مثلاً از طرف کاربران خود) انجام می‌دهد، از پارامتر userIP یا quotaUser برای هر درخواست استفاده کنید تا سهمیه کامل QPS را برای هر کاربر دریافت کنید. برای جزئیات به خلاصه پارامترهای پرس و جو استاندارد مراجعه کنید.

برخی از API ها دارای محدودیت های اضافی هستند. برای جزئیات بیشتر در مورد محدودیت ها و سهمیه های خاص API، به صفحات زیر مراجعه کنید:

خطاهای مربوط به محدودیت ها و سهمیه ها

اگر از سهمیه درخواست Google Analytics API فراتر رود، API کد خطای 403 یا 429 و پیامی مبنی بر اینکه حساب از سهمیه فراتر رفته است را برمی‌گرداند. برای اطلاعات بیشتر به شرایط خدمات مراجعه کنید.

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