تنطبق الحدود والحصص التالية على واجهة Data API.
كيفية تطبيق الحصص
تتطلّب جميع الطلبات الموجّهة إلى Google Analytics Data API v1 مشروعًا على Google Cloud وتخضع للحصص الموضّحة في هذه الصفحة. يتم استهلاك الحصص بغض النظر عن الطريقة المستخدَمة لتحديد المشروع الذي يقدّم الطلب، بما في ذلك:
- الطلبات التي تمّت المصادقة عليها باستخدام بيانات اعتماد OAuth 2.0
- الطلبات التي تمّت المصادقة عليها باستخدام مفتاح واجهة برمجة التطبيقات فقط
تُستخدَم مفاتيح واجهة برمجة التطبيقات لربط طلب بمشروع معيّن على Google Cloud لأغراض الحصة والفوترة. سيتم احتساب جميع طلبات واجهة برمجة التطبيقات التي يتم إجراؤها باستخدام بيانات الاعتماد أو مفتاح واجهة برمجة التطبيقات من مشروعك ضمن الحصص السارية على مشروعك وموقع "إحصاءات Google".
فئات الحصص
تتضمّن واجهة Data API ثلاث فئات لحصص الطلبات، وهي: "التعريف" و"الوقت الفعلي" و"مسار الإحالة الناجحة". تفرض طلبات واجهة برمجة التطبيقات الموجّهة إلى طرق "التعريف" رسومًا على حصص "التعريف". تفرض طلبات واجهة برمجة التطبيقات الموجّهة إلى طرق "الوقت الفعلي" رسومًا على حصص "الوقت الفعلي". يستهلك كل طلب نوعًا واحدًا فقط من الحصص.
| فئة الحصة | طُرق واجهة برمجة التطبيقات |
|---|---|
| عضلات الجذع | runReport وrunPivotReport وbatchRunReports وbatchRunPivotReports وrunAccessReport وgetMetadata وcheckCompatibility وcreateAudienceExports |
| الوقت الفعلي | runRealtimeReport |
| مسار الإحالة الناجحة | runFunnelReport |
حصص مواقع "إحصاءات Google"
تستهلك جميع الطلبات حصص المواقع.
| اسم الحصة | الحدّ العادي للموقع | الحدّ لموقع "إحصاءات 360" |
|---|---|---|
| الرموز المميّزة الأساسية لكل موقع في اليوم | 200000 | 2000000 |
| الرموز المميّزة الأساسية لكل موقع في الساعة | 40000 | 400000 |
| الرموز المميّزة الأساسية لكل مشروع لكل موقع في الساعة | 14000 | 140000 |
| الطلبات المتزامنة الأساسية لكل موقع | 10 | 50 |
| أخطاء الخادم الأساسية لكل مشروع لكل موقع في الساعة | 10 | 50 |
| الرموز المميّزة للوقت الفعلي لكل موقع في اليوم | 200000 | 2000000 |
| الرموز المميّزة للوقت الفعلي لكل موقع في الساعة | 40000 | 400000 |
| الرموز المميّزة للوقت الفعلي لكل مشروع لكل موقع في الساعة | 14000 | 140000 |
| الطلبات المتزامنة للوقت الفعلي لكل موقع | 10 | 50 |
| أخطاء خادم الوقت الفعلي لكل مشروع لكل موقع في الساعة | 10 | 50 |
| الرموز المميّزة لمسار الإحالة الناجحة لكل موقع في اليوم | 200000 | 2000000 |
| الرموز المميّزة لمسار الإحالة الناجحة لكل موقع في الساعة | 40000 | 400000 |
| الرموز المميّزة لمسار الإحالة الناجحة لكل مشروع لكل موقع في الساعة | 14000 | 140000 |
| الطلبات المتزامنة لمسار الإحالة الناجحة لكل موقع | 10 | 50 |
| أخطاء خادم مسار الإحالة الناجحة لكل مشروع لكل موقع في الساعة | 10 | 50 |
- يتم قياس الطلبات المتزامنة من خلال عدد الطلبات التي يتم تنفيذها في الوقت نفسه. لتقليل تزامن الطلبات، يُرجى الانتظار إلى أن تكتمل الطلبات السابقة قبل إرسال طلبات إضافية.
- أخطاء الخادم هي الرمزان 500 و503. لا يتم فرض رسوم على حصص أخطاء الخادم إلا عندما يؤدي الطلب إلى حدوث خطأ في الخادم. عند استنفاد حصص أخطاء الخادم لزوج من المشاريع والمواقع، يتم حظر جميع الطلبات الموجّهة إلى الموقع من المشروع. للاطّلاع على قائمة كاملة بالردود التي تتضمّن أخطاء، يُرجى الانتقال إلى الردود التي تتضمّن أخطاء.
- يستهلك كل طلب حصة كلٍّ من "الرموز المميّزة لكل موقع في الساعة" و"الرموز المميّزة لكل مشروع لكل موقع في الساعة". يعني ذلك أنّه يجب أن يتم الوصول إلى موقع واحد من خلال أكثر من 3 مشاريع قبل أن يتم استنفاد حصة "الرموز المميّزة لكل موقع في الساعة" قبل حصة "الرموز المميّزة لكل مشروع لكل موقع في الساعة".
يُسمح للمواقع بـ 120 طلبًا في الساعة قد يتم تطبيق الحدود عليها. قد يتم تطبيق الحدود على السمات userAgeBracket وuserGender وbrandingInterest وaudienceId وaudienceName. يتم تطبيق الحدود لمنع أي شخص يشاهد التقرير من استنتاج الخصائص الديموغرافية أو الاهتمامات للمستخدمين الفرديين.
حصة الرموز المميّزة للموقع
يتم استهلاك الرموز المميّزة مع كل طلب يتم إرساله إلى Google Analytics Data API v1. يعتمد عدد الرموز المميّزة التي يتم فرض رسوم عليها على مدى تعقيد الطلب. في حين أنّ معظم الطلبات ستفرض رسومًا على 10 رموز مميّزة أو أقل، ستستهلك الطلبات الأكثر تعقيدًا المزيد من الرموز.
العوامل التي تؤثر في استهلاك الرموز المميّزة
يتم تحديد التكلفة الدقيقة للرمز المميّز لطلب معيّن في وقت التنفيذ، ما يجعل من الصعب إجراء عملية حساب دقيقة مسبقًا. تتأثر التكلفة بمجموعة من العوامل المرتبطة بالطلب نفسه والبيانات الأساسية في موقع على "إحصاءات Google". يمكن أن تؤدي هذه العوامل إلى تكاليف أعلى:
- عدد الصفوف: طلب عدد أكبر من الصفوف
- عدد السمات والمقاييس: تضمين عدد أكبر من السمات والمقاييس
- مدى تعقيد الفلتر: استخدام تعبيرات فلتر معقّدة
- طول النطاق الزمني: إجراء طلبات بحث على مدى فترات زمنية أطول
- عدد القيم الفريدة للبيانات: يمكن أن تؤدي السمات التي تتضمّن عددًا كبيرًا من القيم الفريدة (مثل
pagePathوالسمات المخصّصة) إلى زيادة تكلفة الرموز المميّزة بشكلٍ كبير. - عدد أحداث الموقع: قد تستهلك طلبات البحث في المواقع التي تتضمّن عددًا أكبر من الأحداث رموزًا مميّزة أكثر من طلب البحث نفسه في موقع يتضمّن بيانات أقل.
مراقبة استخدام الرموز المميّزة
إنّ الطريقة الأكثر فعالية لتحديد تكلفة الرموز المميّزة لطلبات واجهة برمجة التطبيقات المحدّدة
هي تضمين المَعلمة "returnPropertyQuota": true في نص الطلب.
سيشمل ردّ واجهة برمجة التطبيقات بعد ذلك عنصر PropertyQuota الذي يوضّح الرموز المميّزة التي استهلكها هذا الطلب المحدّد وأرصدة الحصص المتبقية.