تنطبق الحدود والحصص التالية على 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. يتم تطبيق الحدود لمنع أي شخص يشاهد التقرير من استنتاج الخصائص الديموغرافية أو الاهتمامات للمستخدمين الفرديين.
حصة الرموز المميّزة للموقع
يتم احتساب الرموز المميزة مع كل طلب استنادًا إلى مدى تعقيد الطلب. سيتم تحصيل 10 رموز مميّزة أو أقل مقابل معظم الطلبات. عندما يستهلك طلب عددًا كبيرًا من الرموز المميزة للحصة، تكون هذه العوامل غالبًا هي السبب:
- عدد كبير من الصفوف
- عدد كبير من الأعمدة
- معايير فلترة معقّدة
- نطاق زمني طويل
مع كل طلب من واجهة برمجة التطبيقات، يمكنك تحديد "returnPropertyQuota": true في نص الطلب لعرض الحالة الحالية للرموز المميّزة المستخدَمة ضمن حصة الموقع. تحتوي هذه الحالة على كلّ من المبلغ المستهلك من خلال هذا الطلب والمبلغ المتبقّي لكل مجموعة حصص. على سبيل المثال، ننصحك بتحديد هذه المَعلمة في
RunReportRequest.