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

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

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

المقدمة

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

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

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

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

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

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

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

• إصدار Analytics القياسي: 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"

• 100000 وحدة تكلفة طلب بحث في اليوم لكل موقع.
• 25000 وحدة تكلفة طلبات بحث في الساعة لكل موقع.

في حال تجاوزك الحصة المسموح بها، ستتلقّى رسالة خطأ RESOURCE_EXHAUSTED. اطلع على استجابات الخطأ للحصول على التفاصيل.

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

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

حساب التكلفة

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

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

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

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

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

ملاحظات

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

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

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