يصف هذا المستند نظام الحصص المستندة إلى الموارد للإصدار 4 من Google Analytics Reporting API، وهو متاح فقط لعملاء "إحصاءات Google 360". راجِع حدود واجهة برمجة التطبيقات وحصصها للاطّلاع على المجموعة الكاملة من الحدود القصوى المطبَّقة على واجهات برمجة التطبيقات.
مقدمة
لضمان توفّر الموارد المشتركة وموثوقيتها، يخضع كلّ مشروع يصل إلى Analytics Reporting API للحدود والحصص. عند إجراء طلبات بحث في مجموعات بيانات كبيرة، يمكن استخدام أخذ العينات في Analytics Reporting API، ما قد يؤثر في نتائج بياناتك.
إنّ نظام الحصص المستندة إلى الموارد هو نظام حصص جديد سيسمح لحسابات "إحصاءات Google 360" بوضع حدود أعلى لأخذ العيّنات أثناء استخدام Analytics Reporting API. هذا النظام اختياري ومستقل عن الحدود الموضوعة على المشاهدات والمشاريع الحالية، مثل تلك الواردة في صفحة الحصص ضمن Google API Console.
الحصة المستندة إلى الموارد
لا يتم إنشاء جميع الطلبات بالتساوي، فبعض الطلبات تكون أكثر تكلفة من الناحية الحسابية من غيرها. تم تصميم نظام الحصص المستندة إلى الموارد لإتاحة حدّ أعلى من أخذ العينات مع حماية البنية الأساسية لإعداد تقارير "إحصاءات Google" في الوقت نفسه.
سيتم تخصيص كمية محدّدة من الرموز المميّزة لمورد طلب البحث لكلّ موقع. يمكن لعميل واجهة برمجة التطبيقات إضافة حقل اختياري إلى طلب البيانات من واجهة برمجة التطبيقات للحصول على حدّ أعلى لعيّنات البيانات مقابل الرموز المميّزة لمورد طلب البحث النسبي. سيتطلب الطلب الأكثر تكلفة من الناحية الحسابية المزيد من الرموز.
الحدّ الأدنى لأخذ العيّنات
تخضع طلبات البيانات التي تستخدم الإصدار 4 من Google Analytics API للحدود العامة التالية لأخذ العينات استنادًا إلى عدد الجلسات للنطاق الزمني المطلوب (على مستوى الموقع):
- إصدار "إحصاءات Google" العادي: 500 ألف جلسة
- "إحصاءات 360": مليون جلسة
- "إحصاءات Google 360" تستخدم الحصة المستندة إلى الموارد: 100 مليون جلسة
تفعيل الحصة المستندة إلى الموارد
لتفعيل الحصص المستندة إلى الموارد لطلب معيّن، يجب أن يشتمل طلب البيانات من واجهة برمجة التطبيقات على الحقل الاختياري 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
}
تخصيص الحصص
حصة موقع "إحصاءات 360"
- 100,000 وحدة تكلفة لطلب البحث في اليوم لكل موقع.
- 25,000 وحدة تكلفة لطلب البحث في الساعة لكل موقع.
إذا تجاوزت الحدّ الأقصى للحصة المخصّصة لك، ستتلقّى رسالة خطأ واحدة (RESOURCE_EXHAUSTED). لمزيد من التفاصيل، يُرجى الاطّلاع على عمليات الردّ على الأخطاء.
احتساب التكلفة
تتناسب تكلفة الطلب مع:
- حجم النطاق الزمني.
- عدد النتائج ضمن العرض.
- عدد القيم الفريدة للسمة في السمات المطلوبة.
- عدد السمات والمقاييس المطلوبة
- مدى تعقيد تعريفات الشرائح والفلاتر.
- حالة معالجة المعلومات المطلوبة (إنّ طلب بيانات اليوم أكثر تكلفة من طلب بيانات الأمس).
- توفُّر سمات ومقاييس استيراد وقت طلب البحث.
حدود واجهة برمجة التطبيقات واستخدامها
بالإضافة إلى نظام الحصص المستندة إلى الموارد، تخضع واجهات برمجة التطبيقات أيضًا للحدود والحصص في الإصدار 4 من Analytics API.
Notes
- يمثّل حقل الاستجابة
queryCostالتكلفة الحسابية للطلب. وهي ليست تكلفة نقدية، ويمكن استخدام واجهة برمجة التطبيقات مجانًا. - قد تظل تقارير اليوم الواحد وبيانات سابقة معيّنة (منذ سنة أو أكثر) عرضة لأخذ العيّنات، بصرف النظر عن إعداد
useResourceQuotas. - إذا تعذّر استيفاء حدّ أعلى لأخذ العيّنات لأحد الطلبات، لن يتم خصم الرموز المميّزة لحصة الموارد (تكون دائمًا الاستجابات المستندة إلى العيّنات صفرًا في أي تكلفة لحصة الموارد).
- يحتوي التقرير على عيّنات بيانات في حال توفّر الحقلَين
samplesReadCountsوsamplingSpaceSizesفي الردّ.
لعرض حدود الاستخدام أو تغييرها لمشروعك، أو لطلب زيادة في حصتك، عليك اتّباع الخطوات التالية:
- إذا لم يكن لديك حساب فوترة لمشروعك من قبل، عليك إنشاء حساب.
- انتقِل إلى صفحة "واجهات برمجة التطبيقات المفعَّلة" في مكتبة واجهة برمجة التطبيقات في وحدة تحكُّم واجهة برمجة التطبيقات، واختَر واجهة برمجة التطبيقات من القائمة.
- لعرض الإعدادات المتعلقة بالحصص وتغييرها، اختَر الحصص. لعرض إحصاءات الاستخدام، انقر على الاستخدام.