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

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

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

  • ۵۰،۰۰۰ درخواست برای هر پروژه در روز.
  • ۱۰ پرس‌وجو در ثانیه (QPS) به ازای هر آدرس IP
    • در کنسول API ، سهمیه مشابهی با عنوان درخواست‌ها در هر ۱۰۰ ثانیه برای هر کاربر وجود دارد. به طور پیش‌فرض، این سهمیه روی ۱۰۰ درخواست در هر ۱۰۰ ثانیه برای هر کاربر تنظیم شده است و می‌تواند تا حداکثر مقدار ۱۰۰۰ تنظیم شود. اما تعداد درخواست‌ها به API به حداکثر ۱۰ درخواست در هر ثانیه برای هر کاربر محدود شده است.
    • اگر برنامه شما تمام درخواست‌های API را از یک آدرس IP واحد ارسال می‌کند (مثلاً از طرف کاربران شما)، از پارامتر userIp یا quotaUser با هر درخواست استفاده کنید تا سهمیه کامل QPS را برای هر کاربر دریافت کنید.

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

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

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

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