حدود Data API والحصص

تنطبق الحدود والحصص التالية على Data API.

فئات الحصص

تتضمّن Data API ثلاث فئات لحصص الطلبات: "أساسية" و"الوقت الفعلي" و"مسار الإحالة الناجحة". تفرض طلبات البيانات من واجهة برمجة التطبيقات إلى طرق Core رسومًا على حصص Core. تؤدي طلبات واجهة برمجة التطبيقات إلى استخدام حصص "الوقت الفعلي" عند استخدام طرق "الوقت الفعلي". لا يستهلك كل طلب سوى نوع واحد من الحصص.

فئة الحصة	طرق واجهة برمجة التطبيقات
Core	‫runReport وrunPivotReport وbatchRunReports وbatchRunPivotReports وrunAccessReport وgetMetadata وcheckCompatibility وcreateAudienceExports
الوقت الفعلي	runRealtimeReport
مسار الإحالة الناجحة	runFunnelReport

حصص مواقع "إحصاءات Google"

تستهلك جميع الطلبات حصص المواقع.

اسم الحصة	الحدّ العادي للمواقع	الحدّ الأقصى لعدد مواقع "إحصاءات 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. لا يتم تحصيل حصص أخطاء الخادم إلا عندما يؤدي طلب إلى حدوث خطأ في الخادم. عند استنفاد حصص أخطاء الخادم لزوج مشروع وموقع، يتم حظر جميع الطلبات المرسَلة إلى الموقع من المشروع.
• يستهلك كل طلب الحصة لكلّ من "الرموز المميّزة لكلّ موقع في الساعة" و"الرموز المميّزة لكلّ مشروع في الساعة". وهذا يعني أنّه يجب أن يستخدم أكثر من 3 مشاريع موقعًا واحدًا قبل أن يتم استنفاد حصة "الرموز المميّزة لكل موقع في الساعة" قبل حصة "الرموز المميّزة لكل مشروع لكل موقع في الساعة".

ملاحظة: تتم إعادة تحميل جميع الحصص اليومية في منتصف الليل بالتوقيت الرسمي للمحيط الهادئ. تتم إعادة تحميل كل الخطط الزمنية الساعتية في غضون ساعة، ولكن ليس بالضرورة عند حدود الساعة الكاملة.

يُسمح للمواقع بإجراء 120 طلبًا في الساعة قد يتم فرض حدود قصوى عليها. قد يتمّ تطبيق حدّ أدنى على سمات userAgeBracket وuserGender وbrandingInterest وaudienceId و audienceName. يتم تطبيق الحدود لمنع أي شخص يشاهد التقرير من استنتاج الخصائص الديمغرافية أو الاهتمامات للمستخدمين الفرديين.

حصة الرموز المميّزة للموقع

يتم احتساب الرموز المميّزة مع كل طلب استنادًا إلى تعقيد الطلب. ستستخدِم معظم الطلبات 10 رموز مميّزة أو أقل. عندما يستهلك طلب عددًا كبيرًا من الرموز المميّزة للحصة، غالبًا ما تكون هذه العوامل مسؤولة عن ذلك:

• عدد كبير من الصفوف
• عدد كبير من الأعمدة
• معايير الفلتر المعقدة
• نطاق زمني طويل

مع كل طلب من واجهة برمجة التطبيقات، يمكنك تحديد "returnPropertyQuota": true في نص الطلب لعرض حالة الرموز المميّزة الحالية لحصة الموقع. تحتوي هذه الحالة على كلّ من المبلغ المستهلك من خلال هذا الطلب والمبلغ المتبقّي لكلّ مجموعة حصص. على سبيل المثال، ننصحك بتحديد هذه المَعلمة في RunReportRequest.