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