این سند سیستم سهمیه مبتنی بر منابع را برای Google Analytics Reporting API v4 توضیح میدهد که فقط برای مشتریان Analytics 360 در دسترس است. محدودیت ها و سهمیه های API را برای مجموعه کامل محدودیت های اعمال شده برای API ها ببینید.
معرفی
برای اطمینان از در دسترس بودن و قابلیت اطمینان منابع مشترک، هر پروژه ای که به API گزارش تجزیه و تحلیل دسترسی دارد، مشمول محدودیت ها و سهمیه هایی است. هنگام پرس و جو از مجموعه داده های بزرگ، نمونه برداری ممکن است توسط Analytics Reporting API استفاده شود که می تواند بر نتایج داده های شما تأثیر بگذارد.
سیستم سهمیه مبتنی بر منبع یک سیستم سهمیه جدید است که به حساب های Analytics 360 این امکان را می دهد که در حین استفاده از API گزارش تجزیه و تحلیل آستانه نمونه برداری بالاتری داشته باشند. این سیستم اختیاری است و مستقل از محدودیتهای موجود برای بازدیدها و پروژهها ، مانند مواردی که در صفحه سهمیهبندی کنسول API Google گزارش شده است.
سهمیه مبتنی بر منابع
همه درخواست ها یکسان ایجاد نمی شوند. برخی از درخواست ها از نظر محاسباتی بسیار گرانتر از سایرین هستند. سیستم سهمیه مبتنی بر منابع برای پشتیبانی از آستانه بالاتر نمونهگیری طراحی شده است و در عین حال از زیرساخت گزارش تجزیه و تحلیل محافظت میکند.
به هر ویژگی مقدار مجموعه ای از نشانه های منبع پرس و جو اختصاص داده می شود. سرویس گیرنده API می تواند یک فیلد اختیاری به درخواست API اضافه کند تا در ازای توکن های منبع پرس و جو نسبی، آستانه نمونه برداری بالاتری را به دست آورد. یک درخواست گرانتر محاسباتی به توکنهای بیشتری نیاز دارد.
آستانه نمونه برداری
درخواستهای داده با استفاده از Google Analytics API v4 مشمول آستانههای نمونهگیری کلی زیر بر اساس تعداد جلسات برای محدوده تاریخ درخواستی (در سطح دارایی) هستند:
- استاندارد تجزیه و تحلیل: 500 هزار جلسه
- Analytics 360: 1 میلیون جلسه
- Analytics 360 با استفاده از سهمیه مبتنی بر منابع: 100 میلیون جلسه
سهمیه مبتنی بر منبع را فعال کنید
برای فعال کردن سهمیه های مبتنی بر منبع برای یک درخواست معین، فراخوانی API باید شامل فیلد اختیاری useResourceQuotas
در متد batchGet
باشد.
{
"reportRequests": [{object(ReportRequest)}],
"useResourceQuotas": boolean,
}
مثلا:
{
"reportRequests":[
{
"viewId":"XXXX",
"dateRanges":[
{
"startDate":"2017-06-15",
"endDate":"2017-06-30"
}],
"metrics":[
{
"expression":"ga:sessions"
}],
"dimensions": [
{
"name":"ga:browser"
}]
}],
"useResourceQuotas": true
}
فیلد پاسخ به هزینه منابع پرس و جو
برای هر تماس با متد batchGet
، پاسخ یک قسمت queryCost
خواهد داشت.
{
"reports": [{ object(Report) }],
"queryCost": number
}
فیلد queryCost
یک عدد صحیح است که مجموع هزینه منابع تمام ReportRequests
را در درخواست batchGet
نشان می دهد. مثلا:
{
"reports": [
{
"columnHeader": {...},
"data": {
"rows": [...]
}
}
],
"queryCost": 1337
}
تخصیص سهمیه
سهمیه دارایی Analytics 360
- 100000 واحد هزینه پرس و جو در روز برای هر ملک.
- 25000 واحد هزینه پرس و جو در هر ساعت در هر ملک.
اگر از حد مجاز خود فراتر بروید، یک خطای RESOURCE_EXHAUSTED
دریافت خواهید کرد. برای جزئیات بیشتر به پاسخ های خطا مراجعه کنید.
محاسبه هزینه
هزینه درخواست متناسب با:
- اندازه محدوده تاریخ.
- تعداد بازدیدها در نمای.
- اصلی بودن ابعاد درخواستی.
- تعداد ابعاد و معیارهای درخواستی.
- پیچیدگی تعاریف بخش و فیلتر.
- وضعیت پردازش اطلاعات درخواستی (درخواست داده های امروز پرهزینه تر از درخواست داده های دیروز است).
- وجود ابعاد و معیارهای واردات زمان پرس و جو .
محدودیت های API و استفاده
علاوه بر سیستم سهمیه مبتنی بر منبع، APIها نیز توسط محدودیتها و سهمیههای موجود در Analytics API v4 کنترل میشوند.
یادداشت
- قسمت پاسخ
queryCost
هزینه محاسباتی یک درخواست را نشان می دهد. این هزینه پولی نیست و استفاده از API رایگان است. - گزارشهای درون روزی و دادههای تاریخی خاص (بیش از ۱ سال) بدون توجه به تنظیم
useResourceQuotas
ممکن است همچنان مورد نمونهگیری قرار گیرند. - اگر آستانه نمونهگیری بالاتری برای یک درخواست برآورده نشود، نشانههای سهمیه منابع کسر نمیشوند (پاسخهای نمونه همیشه هزینه سهمیه منبع صفر دارند).
- اگر فیلدهای
samplesReadCounts
,samplingSpaceSizes
در پاسخ وجود داشته باشند، یک گزارش حاوی داده های نمونه برداری شده است.
برای مشاهده یا تغییر محدودیتهای استفاده برای پروژه خود، یا درخواست افزایش سهمیه، موارد زیر را انجام دهید:
- اگر قبلاً یک حساب صورتحساب برای پروژه خود ندارید، آن را ایجاد کنید.
- از صفحه Enabled APIs کتابخانه API در کنسول API دیدن کنید و یک API را از لیست انتخاب کنید.
- برای مشاهده و تغییر تنظیمات مربوط به سهمیه، سهمیه ها را انتخاب کنید. برای مشاهده آمار استفاده، استفاده را انتخاب کنید.