الأسئلة الشائعة

إدارة الحصص وزيادة الحصص

هل أنا مؤهّل لزيادة الحصة؟
راجِع طلب حصة إضافية.
ما الحد الأقصى للحصة اليومية لطلبات الإصدار 3 من واجهة برمجة التطبيقات Analytics؟
الحد الأقصى لعدد طلبات البحث في الثانية (QPS) لكل مستخدم هو 10 طلبات، أي أنّه يمكنك إجراء 864,000 طلب في اليوم كحد أقصى لكل مستخدم. يبلغ الحد الأقصى لعدد طلبات البحث في الثانية (QPS) لكل مشروع 20 طلب، أي أنّه يمكنك إجراء 1,728,000 طلب في اليوم كحد أقصى لكل مشروع.
ما هو الحدّ الأقصى المسموح به لزيادة الحصة لطلبات الكتابة في Management API؟
الحد الأقصى للحصة اليومية لكل مشروع من طلبات الكتابة في Management API هو 500. لا نمنح عادةً أكثر من 1,000 إلى 2,000 طلب كتابة لكل مشروع في اليوم. وفي بعض الحالات، نمنح حدودًا أعلى بشكل مؤقت. يُرجى تضمين المبرر في نموذج طلب زيادة الحصة.
هل يمكنني تجميع طلبات واجهة برمجة التطبيقات Management API لحفظ الحصص؟
بالنسبة إلى طلبات User Permission API، يمكنك تجميعها لتوفير الحصص. بالنسبة إلى الطلبات الأخرى من واجهة برمجة التطبيقات، لا يمكنك إجراء ما يلي: يتم احتساب كل إدخال في الطلب المجمّع ضمن الحصة اليومية للمشروع.
على الرغم من أنّ حصّة استخدام واجهة برمجة التطبيقات الخاصة بخدمة "إحصاءات Google" بسيطة في مشروعنا، نحن نستعد لإطلاق مشروع جديد ونتوقع عددًا كبيرًا من المستخدمين. هل يمكننا طلب زيادة الحصة مؤقتًا؟
ننصحك بشدة باختبار التحميل الواقعي أولاً للتأكّد من أنه يمكنك الحفاظ على معدلات خطأ منخفضة للطلبات المتكررة من واجهة برمجة التطبيقات.
استخدام حصة طلبات واجهة برمجة التطبيقات في "إحصاءات Google" أقل بكثير من الحصة الحالية المسموح بها للمشروع. هل سأفقد الحصة التي تمت زيادتها؟
نحن نراجع استخدام حصص طلبات البيانات من واجهة برمجة التطبيقات ونتراجع عن الزيادات في الحصة إذا كان معدّل الاستخدام منخفضًا باستمرار لفترة طويلة (أي عدة أشهر) أو إذا زاد معدّل أخطاء طلبات البيانات من واجهة برمجة التطبيقات بشكل كبير.
لديّ حصة يومية تلقائية تبلغ 50,000 طلب من واجهة برمجة التطبيقات. هل يمكنني طلب 1,000,000؟
لا نزيد الحصة اليومية لأكثر من 100%. بالتالي، يمكننا زيادة حصتك اليومية إلى 100,000 على الأكثر. يمكنك طلب حصة إضافية مع تزايد طلبات مشروعك.
تلقيتُ رسالة إلكترونية تفيد بأنه تمت الموافقة على طلب زيادة الحصة، ولكنني لا أرى التغيير. لماذا؟
يستغرق تطبيق زيادة الحصة ما يصل إلى 24 ساعة. إذا لم تلاحظ الزيادة خلال 48 ساعة، يُرجى إعلامنا من خلال الردّ على الرسالة الإلكترونية الخاصة بتأكيد الموافقة.
لقد أرسلتُ طلبًا لزيادة الحصة ولم أتلقَّ أي ردّ لعدة أيام. لماذا؟
إذا لم يصلك ردّ بعد 48 ساعة من طلبك، تأكَّد من ملء نموذج طلب الحصة بشكلٍ صحيح واستيفاء الحد الأدنى من المتطلبات قبل التواصل معنا.
تم رفض طلب زيادة الحصة. ماذا يمكنني أن أفعل للحصول على موافقة؟
إذا تم رفض طلب زيادة الحصة، يُرجى حلّ المشاكل المذكورة في رسالة الرفض الإلكترونية. نحن لا نزيد حصتك عندما (1) لم تقدم أسبابًا لاستخدام الزيادة المقترحة في الحصة و/أو (2) يحتوي مشروعك على معدل أخطاء مرتفع.
معدل أخطاء طلب واجهة برمجة التطبيقات في "إحصاءات Google" مرتفع. هل سأفقد الحصة التي تمت زيادتها؟
احتمال كبير. نحن نراجع استخدام حصص طلبات البيانات من واجهة برمجة التطبيقات ونتراجع عن زيادات الحصّة إذا كان معدّل الاستخدام منخفضًا لفترة طويلة (أي عدة أشهر) أو إذا ازداد معدّل الخطأ في طلبات البيانات من واجهة برمجة التطبيقات.
بغض النظر عن حصتي، إذا قدّمت أكثر من 10,000 طلب من واجهة برمجة التطبيقات لكل مشاهدة (الملف الشخصي)، تظهر لي رسالة الخطأ dailyLimitExceeded. لماذا؟
لا يمكن زيادة الحصة التي تبلغ 10,000 طلب من واجهة برمجة التطبيقات لكل مشاهدة (الملف الشخصي).
ما هي الحصص القصوى المسموح بها لطلبات واجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي؟
50,000 طلب لكل مشروع في اليوم و10 طلبات في الثانية (QPS) لكل عنوان IP.
ماذا يعني خطأ داخلي في الخادم؟
نفِّذ ميزة التراجع الأُسيّ لإعادة إرسال طلب البيانات من واجهة برمجة التطبيقات. إذا تعذّر تنفيذ الطلب نفسه دائمًا عند ظهور رمز الاستجابة 500 أو إذا ظهر لك عدد كبير من الطلبات التي يتعذّر تنفيذها مع رمز الاستجابة 500، يُرجى التواصل معنا.
أستخدِم الإصدار الثالث من Core Reporting API، فلماذا يجب عليّ نقل البيانات إلى الإصدار 4 من Google Analytics Reporting API؟
استخدام الميزات التي تم تنفيذها في الإصدار 4 فقط: بالإضافة إلى ذلك، يوفّر الإصدار 4 من Reporting API نموذج حصص أكثر مرونة يتيح زيادة عدد الطلبات في الثانية (QPS) مقارنةً بالإصدار الثالث، وسيستمر تطويره في المستقبل.
هل يمكنني الاحتفاظ بالحصص المتزايدة لكل من الإصدار الثالث من واجهة برمجة التطبيقات الأساسية لإعداد التقارير والإصدار الرابع من Google Analytics Reporting API؟
لا، لنفترض أنّك رفعت حصة الطلبات للإصدار 3 إلى x. وفي حال الانتقال إلى الإصدار 4، ستحصل أيضًا على x للإصدار 4، ولكن في النهاية ستتم إعادة حصة الإصدار 3 إلى الحصة التلقائية في نهاية الفترة الانتقالية التي تستمر حوالي 3 أشهر من تاريخ زيادة حصة واجهة برمجة التطبيقات v4".

مراقبة استخدام واجهة برمجة التطبيقات وتسجيلها

كيف يمكنني الحصول على أخطاء عند استخدام رموز معيّنة؟
بدءًا من الإصدار 4 من Google Analytics Reporting API، يمكنك استخدام Play Console للاطّلاع على تفاصيل طلبات البيانات من واجهة برمجة التطبيقات حسب رمز الخطأ الخاص بالاستجابة. يُرجى العلم أنّه لا يمكن في الوقت الحالي استخدام وحدة تحكّم المطوّرين لرؤية بيانات الطلبات الفردية.
تم تثبيت تطبيقي على أجهزة المستخدمين (مثل إضافة متصفّح). كيف يمكنني الحصول على السجلات، واستكشاف الأخطاء وإصلاحها، ومراقبة الاستخدام؟
لا توفّر واجهة برمجة تطبيقات "إحصاءات Google" حاليًا طريقة مركزية للوصول إلى هذه المعلومات. وفي تلك الأثناء، يمكنك تنفيذ تتبّع الأحداث في "إحصاءات Google" لتتبُّع أخطاء واجهة برمجة التطبيقات.