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