محدودیتها و سهمیههای زیر برای 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 به طور بالقوه دارای آستانه هستند. آستانهها اعمال میشوند تا از استنباط جمعیتشناختی یا علایق کاربران توسط هر کسی که گزارش را مشاهده میکند، جلوگیری شود.
سهمیه توکنهای املاک
توکنها با هر درخواست بسته به پیچیدگی آن محاسبه میشوند. اکثر درخواستها 10 توکن یا کمتر هزینه دارند. وقتی تعداد زیادی توکن سهمیه توسط یک درخواست مصرف میشود، اغلب این عوامل مسئول هستند:
- تعداد زیاد ردیفها
- تعداد زیاد ستونها
- معیارهای فیلتر پیچیده
- محدوده زمانی طولانی
با هر درخواست API، میتوانید در بدنه درخواست "returnPropertyQuota": true برای بازگرداندن وضعیت فعلی توکنهای سهمیهبندی دارایی تعیین کنید. این وضعیت شامل مقدار مصرف شده توسط این درخواست و مقدار باقی مانده برای هر گروه سهمیهبندی است. برای مثال، تعیین این پارامتر را در RunReportRequest در نظر بگیرید.