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

این سند محدودیت ها و سهمیه های درخواست 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 کامل برای هر کاربر را دریافت کنید. برای جزئیات به خلاصه پارامترهای پرس و جو استاندارد مراجعه کنید.

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

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

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

فقط می توانید درخواست افزایش دهید:

برای مشاهده یا تغییر محدودیت‌های استفاده برای پروژه خود، یا درخواست افزایش سهمیه، موارد زیر را انجام دهید:

  1. اگر قبلاً یک حساب صورتحساب برای پروژه خود ندارید، آن را ایجاد کنید.
  2. از صفحه Enabled APIs کتابخانه API در کنسول API دیدن کنید و یک API را از لیست انتخاب کنید.
  3. برای مشاهده و تغییر تنظیمات مربوط به سهمیه، سهمیه ها را انتخاب کنید. برای مشاهده آمار استفاده، استفاده را انتخاب کنید.

برای درخواست افزایش حداکثر مقدار سهمیه، لطفاً از فرم درخواست سهمیه 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ها و استفاده محدود مراجعه کنید.