ویژگی‌های استاندارد Universal Analytics (UA) پردازش داده‌ها را در 1 ژوئیه 2023 متوقف کردند . دارایی‌های UA 360 پردازش داده‌ها را در تاریخ 1 ژوئیه 2024 متوقف خواهند کرد و برخی از ویژگی‌های UA 360 قبل از آن منسوخ خواهند شد ، زیرا ما به Google Analytics 4 منتقل می‌شویم . از Admin API برای تهیه و مدیریت ویژگی های GA4 استفاده کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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

API های مدیریت

Google Analytics سهمیه‌هایی را برای درخواست‌های این APIهای مدیریت اعمال می‌کند:

API ها را بنویسید
API واردات داده
Experiments API
Unsampled Reports API
API مجوز کاربر

API ها را بنویسید

این سهمیه ها برای درخواست های نوشتن ( insert ، update ، patch و delete ) اعمال می شود:

50 درخواست نوشتن در هر پروژه در روز، که می تواند افزایش یابد
1.5 پرس و جو در ثانیه (QPS) در هر شناسه حساب

خطاهای درخواست را بنویسید

اگر درخواست نوشتن شما ناموفق بود و کد پاسخ 500 یا 503 را دریافت کردید، می توانید آن را دوباره ارسال کنید. Google Analytics اجازه می دهد:

50 درخواست نوشتن ناموفق در ساعت.

اگر بخواهید بیش از 50 درخواست نوشتن ناموفق در ساعت ارسال کنید، با خطای زیر مواجه خواهید شد:

Quota Error: The number of recent failed writes is too high.

به جای ارسال مجدد مداوم درخواست نوشتن ناموفق، برای ارسال مجدد آن ، Backoff نمایی را اجرا کنید .

API واردات داده

این سهمیه ها مختص منبع Uploads هستند:

محدودیت‌های ذخیره‌سازی واردات داده‌های طولانی‌مدت در طول عمر (در مورد داده‌های پرطرفدار ارسال شده از APIها و SDKهای مجموعه اعمال نمی‌شود):
- محدودیت های Analytics 360 برای حالت واردات زمان پردازش :
  - 1 ترابایت در هر ملک
  - 20 گیگابایت در هر مجموعه داده
- محدودیت‌های Analytics 360 برای حالت وارد کردن زمان درخواست :
  - 1 گیگابایت برای هر ملک
  - 1 گیگابایت در هر مجموعه داده
- محدودیت های استاندارد:
  - 10 گیگابایت برای هر ملک
  - 10 گیگابایت در هر مجموعه داده
50 مجموعه داده در هر ویژگی
50 عملیات آپلود در هر ملک در روز
1 گیگابایت در هر فایل آپلود شده
محدودیت‌های خاص داده‌های هزینه:
- 100 مگابایت در هر تاریخ ( ga:date ) در هر مجموعه داده. به عنوان مثال، اگر 50 مگابایت داده را برای 2014-10-10 در یک بار آپلود و 50 مگابایت داده را برای 2014-10-10 در بارگذاری دوم وارد کنید، به محدودیت 100 مگابایت برای 2014-10-10 برای آن مجموعه داده رسیده اید. .

Experiments API

این سهمیه فقط برای آزمایش‌ها اعمال می‌شود:

12 آزمایش در هر بازدید (نمایه)

آزمایش‌ها با یکی از statuses زیر در این سهمیه به حساب می‌آیند:

DRAFT
READY_TO_RUN
RUNNING

آزمایش‌هایی که بیش از یک روز به پایان رسیده‌اند (وضعیت = ENDED ) در این سهمیه حساب نمی‌شوند.

Unsampled Reports API

این سهمیه‌ها فقط برای گزارش‌های نمونه‌برداری نشده اعمال می‌شوند:

درخواست‌های API برای ایجاد گزارش‌های بدون نمونه در سهمیه کلی درخواست‌های نوشتن حساب می‌شوند.
API از همان سیستم توکن در روز برای هر ویژگی استفاده می کند که رابط وب از آن برای ایجاد گزارش های بدون نمونه استفاده می کند.
حداکثر تعداد گزارش های بدون نمونه مجاز 3500 گزارش است. وقتی به این حد رسید، تلاش برای ایجاد گزارش‌های بدون نمونه بیشتر با API منجر به خطای زیر می‌شود:
```
Error creating this entity. You have reached the maximum allowed entities of this type.
```

API مجوز کاربر

این سهمیه فقط برای مجوزهای کاربر اعمال می شود:

یک کاربر می تواند حداکثر 100 حساب Analytics داشته باشد. افزودن کاربری که دارای 100 حساب Analytics به یک حساب جدید است باعث ایجاد خطا می شود.

سهمیه‌های زیر برای درخواست‌های نوشتن دسته‌ای ( delete ، insert ، update ) برای مجوزهای کاربر اعمال می‌شود:

300 درخواست نوشتن مجوز کاربر در هر درخواست دسته ای
30 دسته درخواست نوشتن مجوز کاربر به عنوان 1 درخواست نوشتن شمارش می شود

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

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