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

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

هل أنا مؤهّل لزيادة الحصة؟
يمكنك الاطّلاع على طلب حصة إضافية.
ما الحد الأقصى للحصة اليومية المطلوبة لطلبات الإصدار 3 من واجهة برمجة تطبيقات Analytics؟
الحد الأقصى لعدد طلبات البحث في الثانية لكل مستخدم هو 10 طلبات، ما يعني أنّه يمكنك تقديم 864,000 طلب كحد أقصى في اليوم لكل مستخدم. الحد الأقصى لعدد طلبات البحث في الثانية لكل مشروع هو 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 نموذج حصص أكثر مرونة يتيح زيادة عدد الطلبات في الثانية مقارنةً بالإصدار الثالث، وسيواصل تطويره في المستقبل.
هل يمكنني الحفاظ على الحصص المتزايدة لكل من الإصدار الثالث من واجهة برمجة التطبيقات الأساسية لإعداد التقارير والإصدار الرابع من واجهة برمجة التطبيقات لإعداد التقارير في "إحصاءات Google"؟
لا، لنفترض أنّك أضفت حصة طلباتك للإصدار 3 إلى الإصدار x. وفي حال الانتقال إلى الإصدار 4، ستحصل أيضًا على x للإصدار 4، ولكن ستتم إعادة حصة الإصدار 3 إلى الحصة التلقائية في نهاية الفترة الانتقالية التي تستغرق حوالى 3 أشهر من وقت زيادة حصة واجهة برمجة التطبيقات الإصدار 4".

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

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