الحصة المستندة إلى المورد

يوضّح هذا المستند نظام الحصص المستندة إلى الموارد للإصدار 4 من Google Analytics Reporting API، المتاح فقط لعملاء "إحصاءات 360". اطّلع على الحدود والحصص الخاصة بواجهة برمجة التطبيقات للتعرّف على المجموعة الكاملة للحدود المطبَّقة على واجهات برمجة التطبيقات.

تتوفّر ميزة الحصص المستندة إلى الموارد حاليًا لجميع عملاء "إحصاءات 360".

مقدمة

لضمان توفّر الموارد المشتركة وموثوقيتها، يخضع كل مشروع يصل إلى Analytics Reporting API للحدود والحصص. عند إجراء طلبات بحث في مجموعات بيانات كبيرة، قد يتم استخدام أخذ العينات بواسطة Analytics Reporting API، ما قد يؤثر في نتائج بياناتك.

إنّ نظام الحصص المستند إلى الموارد هو نظام حصص جديد سيمكّن حسابات "إحصاءات 360" من وضع حدود أعلى لأخذ العينات أثناء استخدام Analytics Reporting API. هذا النظام اختياري ومستقل عن الحدود الحالية المفروضة على المشاهدات والمشاريع، مثل تلك التي يتم الإبلاغ عنها في صفحة الحصص لوحدة تحكُّم Google API.

الحصة المستندة إلى الموارد

لا يتم إنشاء جميع الطلبات بالتساوي، فبعض الطلبات تكون أكثر تكلفة من الناحية الحسابية بكثير من غيرها. تم تصميم نظام الحصص المستندة إلى الموارد لإتاحة حدّ أعلى من أخذ العيّنات مع الاستمرار في حماية البنية الأساسية لإعداد تقارير "إحصاءات Google".

سيتم تخصيص مقدار محدّد من الرموز المميّزة لمورد طلبات البحث لكل موقع. يمكن لعميل واجهة برمجة التطبيقات إضافة حقل اختياري إلى طلب البيانات من واجهة برمجة التطبيقات للحصول على حدّ أعلى لأخذ العينات في مقابل الرموز المميّزة النسبية لمورد طلب البحث. سيتطلب الطلب الأغلى من الناحية الحسابية المزيد من الرموز المميّزة.

حدّ أخذ العيّنات

تخضع طلبات البيانات التي تستخدِم الإصدار 4 من Google Analytics API للحدود العامة التالية لأخذ العينات استنادًا إلى عدد الجلسات للنطاق الزمني المطلوب (على مستوى الموقع):

• إصدار "إحصاءات Google" العادي: 500 ألف جلسة
• "إحصاءات 360": مليون جلسة
• استخدام "إحصاءات 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). راجِع الردود على الأخطاء للاطّلاع على التفاصيل.

ملاحظة: هذه القيم أولية وقد تتغير أثناء الفترة التجريبية و/أو بعدها.

ملاحظة مهمة: تتم إعادة تحميل الحصص اليومية عند منتصف الليل بتوقيت المحيط الهادئ.

احتساب التكلفة

تتناسب تكلفة الطلب مع:

• حجم النطاق الزمني.
• عدد النتائج ضمن الملف الشخصي.
• عدد القيم الفريدة للسمة المطلوبة:
• عدد السمات والمقاييس المطلوبة.
• مدى تعقيد تعريفات الشرائح والتصفية.
• حالة معالجة المعلومات المطلوبة (إنّ طلب بيانات اليوم أكثر تكلفة من طلب بيانات الأمس).
• توفُّر سمات ومقاييس استيراد وقت طلب البحث

ملاحظة: إذا انتهت المهلة في أحد الطلبات، وأدى ذلك إلى استجابة 5XX، سيتم فرض تكلفة حصة الموارد. يمكنك الاطّلاع على صفحة الاستجابة للخطأ للحصول على تفاصيل عن تنفيذ ميزة "التراجع الأُسيّ" لمنع الاستخدام المفرط للحصة.

حدود واجهة برمجة التطبيقات واستخدامها

بالإضافة إلى نظام الحصص المستند إلى الموارد، تخضع واجهات برمجة التطبيقات أيضًا لحدود وحصص الإصدار 4 من Analytics API.

Notes

• يمثّل حقل الاستجابة queryCost التكلفة الحاسوبية لأحد الطلبات. وهي ليست تكلفة نقدية، وواجهة برمجة التطبيقات مجانية الاستخدام.
• قد تظلّ التقارير خلال اليوم الواحد وبعض البيانات السابقة (المعروضة منذ أكثر من سنة) عرضة لأخذ العيّنات، بغض النظر عن الإعداد useResourceQuotas.
• إذا تعذّر استيفاء حدّ أخذ عيّنات أعلى لأحد الطلبات، لن يتمّ خصم الرموز المميّزة لحصة الموارد (تكون دائمًا الردود المستندة إلى عينات صفرية).
• يحتوي التقرير على عيّنات من البيانات في حال توفّر الحقلَين samplesReadCounts وsamplingSpaceSizes في الاستجابة.

لعرض حدود الاستخدام لمشروعك أو تغييرها أو لطلب زيادة في حصتك، عليك اتّباع الخطوات التالية:

1. إذا لم يكن لديك حساب فوترة لمشروعك من قبل، عليك إنشاء حساب.
2. انتقِل إلى صفحة "واجهات برمجة التطبيقات المفعّلة" في مكتبة واجهة برمجة التطبيقات في وحدة تحكّم واجهة برمجة التطبيقات، واختَر واجهة برمجة تطبيقات من القائمة.
3. لعرض الإعدادات المتعلقة بالحصص وتغييرها، اختَر الحصص. لعرض إحصاءات الاستخدام، انقر على الاستخدام.