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