هر درخواست API تأیید می کند که سهمیه ها تمام نشده اند و سهمیه ها را مصرف می کند. اگر هر سهمیه ای تمام شود، درخواست با یک پیام خطای مربوطه ناموفق می شود. هر درخواست Data API چندین سطل سهمیه را بررسی می کند.
دسته بندی سهمیه
برای اهداف سهمیه، Data API دارای سه دسته درخواست است: Core، Realtime، و Funnel. درخواست‌های API به روش‌های Core سهمیه‌های Core را شارژ می‌کنند. درخواست‌های API به روش‌های Realtime سهمیه‌های Realtime را شارژ می‌کنند. یک درخواست هر دو سهمیه Core و Realtime را مصرف نمی کند. اینها روش ها و دسته بندی های API هستند:
| دسته سهمیه | روش های API |
|---|---|
| هسته | runReport , runPivotReport , batchRunReports , batchRunPivotReports , runAccessReport , getMetadata , checkCompatibility , createAudienceExports |
| به موقع | runRealtimeReport |
| قیف | runFunnelReport |
سهمیه های دارایی Analytics
تمام درخواست ها سهمیه املاک را مصرف می کنند.
| نام سهمیه | حد استاندارد املاک | محدودیت دارایی Analytics 360 |
|---|---|---|
| توکن های اصلی در هر ملک در روز | 200000 | 2,000,000 |
| توکن های اصلی در هر ملک در ساعت | 40000 | 400000 |
| توکن های اصلی در هر پروژه در هر ملک در ساعت | 14000 | 140000 |
| درخواست های همزمان اصلی برای هر ملک | 10 | 50 |
| خطاهای اصلی سرور در هر پروژه در هر ویژگی در ساعت | 10 | 50 |
| توکن های بیدرنگ در هر ملک در روز | 200000 | 2,000,000 |
| توکن های بیدرنگ در هر ملک در ساعت | 40000 | 400000 |
| توکن های بیدرنگ در هر پروژه در هر ملک در ساعت | 14000 | 140000 |
| درخواست های همزمان بیدرنگ برای هر ملک | 10 | 50 |
| خطاهای سرور بلادرنگ در هر پروژه در هر ویژگی در ساعت | 10 | 50 |
| قیف توکن در هر ملک در روز | 200000 | 2,000,000 |
| قیف توکن در هر ملک در ساعت | 40000 | 400000 |
| توکن های قیف در هر پروژه در هر ملک در ساعت | 14000 | 140000 |
| قیف درخواست های همزمان برای هر ملک | 10 | 50 |
| خطاهای سرور قیف در هر پروژه در هر ویژگی در ساعت | 10 | 50 |
- درخواست های همزمان با تعداد درخواست هایی که به طور همزمان اجرا می شوند اندازه گیری می شوند. برای کاهش همزمانی درخواست خود، قبل از ارسال درخواست‌های اضافی منتظر بمانید تا درخواست‌های قبلی تکمیل شوند.
- خطاهای سرور کدهای 500 و 503 هستند. سهمیه خطاهای سرور تنها زمانی شارژ می شود که یک درخواست خطاهای سرور داشته باشد. هنگامی که سهمیه خطاهای سرور برای یک جفت پروژه و دارایی تمام می شود، تمام درخواست های پروژه به ویژگی مسدود می شود.
- هر درخواست سهمیه ای برای هر دو توکن در هر ملک در ساعت و توکن در هر پروژه در هر ملک در ساعت مصرف می کند. این به این معنی است که قبل از اتمام سهمیه "Tokens Per Property Per Hour" قبل از "Tokens Per Project Per Property Per Hour" سهمیه "Tokens Per Project Per Property Per Hour" به بیش از 3 پروژه باید دسترسی داشته باشد.
اموال مجاز به 120 درخواست آستانه بالقوه در هر ساعت هستند. ابعاد userAgeBracket ، userGender ، brandingInterest ، audienceId ، و audienceName به طور بالقوه دارای آستانه هستند. آستانه‌ها برای جلوگیری از استنباط اطلاعات جمعیتی یا علائق کاربران فردی که گزارشی را مشاهده می‌کنند، اعمال می‌شوند.
سهمیه نمادهای املاک
توکن ها با هر درخواست بسته به پیچیدگی درخواست برای تکمیل محاسبه می شوند. اکثر درخواست ها 10 توکن یا کمتر را شارژ می کنند. هنگامی که تعداد زیادی از توکن های سهمیه توسط یک درخواست مصرف می شود، این عوامل اغلب مسئول هستند:
- تعداد ردیف زیاد
- تعداد زیادی ستون
- معیارهای فیلتر پیچیده
- محدوده تاریخ طولانی
با هر درخواست API، می‌توانید "returnPropertyQuota": true در بدنه درخواست برای بازگرداندن وضعیت فعلی سهمیه ویژگی‌ها. این وضعیت هم مقدار مصرف شده توسط این درخواست و هم مقدار باقی مانده برای هر گروه سهمیه را شامل می شود. برای مثال، مشخص کردن این پارامتر را در RunReportRequest در نظر بگیرید.