محدودیتها و سهمیههای زیر برای Data API اعمال میشود.
نحوه اعمال سهمیهها
تمام درخواستها به Google Analytics Data API نسخه ۱ نیاز به یک پروژه Google Cloud دارند و مشمول سهمیههای ذکر شده در این صفحه هستند. سهمیهها صرف نظر از روشی که برای شناسایی پروژه فراخوانی استفاده میشود، مصرف میشوند، از جمله:
- درخواستها با اعتبارنامههای OAuth 2.0 تأیید اعتبار میشوند.
- درخواستها فقط با استفاده از یک کلید API تأیید میشوند.
کلیدهای API برای مرتبط کردن یک درخواست با یک پروژه خاص Google Cloud برای اهداف سهمیهبندی و صدور صورتحساب استفاده میشوند. تمام فراخوانیهای API که با استفاده از اعتبارنامهها یا یک کلید API از پروژه شما انجام میشوند، در سهمیههای قابل اجرا برای پروژه شما و دارایی Google Analytics محاسبه میشوند.
دسته بندی سهمیه ها
API داده سه دسته سهمیه درخواست دارد: هسته، بیدرنگ و قیفی. درخواستهای API به متدهای هسته، سهمیههای هسته را شارژ میکنند. درخواستهای API به متدهای بیدرنگ، سهمیههای بیدرنگ را شارژ میکنند. هر درخواست فقط یک نوع سهمیه مصرف میکند.
| دسته بندی سهمیه | روشهای API |
|---|---|
| هسته | runReport ، runPivotReport ، batchRunReports ، batchRunPivotReports ، runAccessReport ، getMetadata ، checkCompatibility ، createAudienceExports |
| بیدرنگ | runRealtimeReport |
| قیف | runFunnelReport |
سهمیههای املاک تحلیلی
همه درخواستها سهمیههای دارایی را مصرف میکنند.
| نام سهمیه | محدودیت استاندارد املاک | محدودیت املاک آنالیتیکس ۳۶۰ |
|---|---|---|
| توکنهای اصلی به ازای هر ملک در هر روز | ۲۰۰۰۰۰ | ۲،۰۰۰،۰۰۰ |
| توکنهای اصلی به ازای هر ملک در هر ساعت | ۴۰،۰۰۰ | ۴۰۰۰۰۰ |
| توکنهای اصلی به ازای هر پروژه به ازای هر ملک به ازای هر ساعت | ۱۴۰۰۰ | ۱۴۰،۰۰۰ |
| درخواستهای همزمان اصلی به ازای هر ویژگی | ۱۰ | ۵۰ |
| خطاهای سرور اصلی به ازای هر پروژه به ازای هر ملک به ازای هر ساعت | ۱۰ | ۵۰ |
| توکنهای آنی به ازای هر ملک در هر روز | ۲۰۰۰۰۰ | ۲،۰۰۰،۰۰۰ |
| توکنهای آنی به ازای هر ملک در هر ساعت | ۴۰،۰۰۰ | ۴۰۰۰۰۰ |
| توکنهای آنی به ازای هر پروژه، به ازای هر ملک، به ازای هر ساعت | ۱۴۰۰۰ | ۱۴۰،۰۰۰ |
| درخواستهای همزمان بلادرنگ برای هر ملک | ۱۰ | ۵۰ |
| خطاهای سرور در لحظه به ازای هر پروژه به ازای هر ملک به ازای هر ساعت | ۱۰ | ۵۰ |
| توکنهای قیفی به ازای هر ملک در هر روز | ۲۰۰۰۰۰ | ۲،۰۰۰،۰۰۰ |
| توکنهای قیفی به ازای هر ملک در هر ساعت | ۴۰،۰۰۰ | ۴۰۰۰۰۰ |
| توکنهای قیفی به ازای هر پروژه به ازای هر ملک به ازای هر ساعت | ۱۴۰۰۰ | ۱۴۰،۰۰۰ |
| درخواستهای همزمان قیفی به ازای هر ملک | ۱۰ | ۵۰ |
| خطاهای سرور قیف فروش به ازای هر پروژه به ازای هر ملک به ازای هر ساعت | ۱۰ | ۵۰ |
- درخواستهای همزمان با تعداد درخواستهایی که همزمان اجرا میشوند، سنجیده میشوند. برای کاهش همزمانی درخواستهایتان، قبل از ارسال درخواستهای اضافی، منتظر بمانید تا درخواستهای قبلی تکمیل شوند.
- خطاهای سرور کدهای ۵۰۰ و ۵۰۳ هستند. سهمیه خطاهای سرور فقط زمانی محاسبه میشود که یک درخواست منجر به خطای سرور شود. وقتی سهمیه خطاهای سرور برای یک جفت پروژه و ویژگی تمام شود، تمام درخواستها به ویژگی از پروژه مسدود میشوند.
- هر درخواست، سهمیهی «توکن به ازای هر ملک در ساعت» و «توکن به ازای هر پروژه به ازای هر ملک در ساعت» را مصرف میکند. این بدان معناست که یک ملک باید توسط بیش از ۳ پروژه مورد دسترسی قرار گیرد تا سهمیهی «توکن به ازای هر ملک در ساعت» قبل از سهمیهی «توکن به ازای هر پروژه به ازای هر ملک در ساعت» تمام شود.
ویژگیها مجاز به دریافت ۱۲۰ درخواست با آستانهی احتمالی در ساعت هستند. ابعاد userAgeBracket ، userGender ، brandingInterest ، audienceId و audienceName به طور بالقوه دارای آستانه هستند. آستانهها اعمال میشوند تا از استنباط جمعیتشناختی یا علایق کاربران توسط هر کسی که گزارش را مشاهده میکند، جلوگیری شود.
سهمیه توکنهای املاک
توکنها با هر درخواست به Google Analytics Data API نسخه ۱ مصرف میشوند. تعداد توکنهای دریافتی به پیچیدگی درخواست بستگی دارد. در حالی که اکثر درخواستها ۱۰ توکن یا کمتر هزینه دارند، درخواستهای پیچیدهتر مصرف بیشتری خواهند داشت.
عواملی که بر مصرف توکن تأثیر میگذارند
هزینه دقیق توکن برای یک درخواست در زمان اجرا تعیین میشود، که محاسبه دقیق پیش از اجرا را چالشبرانگیز میکند. هزینه تحت تأثیر ترکیبی از عوامل مرتبط با خود درخواست و دادههای اساسی در ویژگی Google Analytics قرار دارد. این عوامل میتوانند منجر به هزینههای بالاتر شوند:
- تعداد ردیفها: درخواست تعداد ردیفهای بیشتر.
- تعداد ابعاد و معیارها: شامل تعداد بیشتری از ابعاد و معیارها.
- پیچیدگی فیلتر: استفاده از عبارات فیلتر پیچیده.
- طول بازه زمانی: پرسوجو در بازههای زمانی طولانیتر.
- کاردینالیتی دادهها: ابعاد با کاردینالیتی بالا (مقادیر منحصر به فرد زیاد، مانند
pagePath، ابعاد سفارشی) میتوانند هزینه توکن را به میزان قابل توجهی افزایش دهند. - حجم رویدادهای ملک: کوئریها روی ملکهایی با حجم رویدادهای بیشتر، ممکن است توکنهای بیشتری نسبت به همان کوئری روی ملکهایی با دادههای کمتر مصرف کنند.
نظارت بر استفاده از توکن
موثرترین راه برای تعیین هزینه توکن برای فراخوانیهای خاص API شما، گنجاندن پارامتر "returnPropertyQuota": true در بدنه درخواست است. سپس پاسخ API شامل شیء PropertyQuota خواهد بود که جزئیات توکنهای مصرف شده توسط آن درخواست خاص و موجودی سهمیه باقیمانده را شرح میدهد.