يصف هذا المستند واجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي على "إحصاءات Google". للحصول على مرجع مفصّل لواجهة برمجة التطبيقات، يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات.
مقدمة
تتيح لك "واجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي" طلب بيانات في الوقت الفعلي لمستخدم تمت مصادقته، مثل النشاط في الوقت الفعلي على موقعك.
يمكنك استخدام واجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي لإجراء ما يلي:
- اعرض المنتج أو الخدمة للمشاهدين النشطين لصفحة وقدِّم لهم شعورًا بالإلحاح لدى المستخدمين الذين يبحثون عن سلعة متوفّرة في مستودع محدود.
- عرض المحتوى الأكثر رواجًا مثل أهم 10 صفحات نشطة
- إنشاء لوحة بيانات في الوقت الفعلي وعرضها
الخادم الوكيل المميّز في "إحصاءات Google"
استخدِم SuperProxy في "إحصاءات Google" لمعالجة العديد من تفاصيل التنفيذ المتعلقة بواجهات برمجة تطبيقات "إحصاءات Google" في المصادقة والتخزين المؤقت وتحويل استجابات واجهة برمجة التطبيقات للتنسيقات المستخدَمة مباشرةً مع مكتبات العروض المرئية والرسومات البيانية.
نظرة عامة على المفاهيم
وفي ما يلي المفاهيم الأساسية التي يستند إليها واجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي:
- طريقة ارتباط التقارير بالمستخدمين والمشاهدات (الملفات الشخصية).
- بنية التقرير وكيفية إنشاء الاستعلامات.
- جارٍ العمل على استجابة واجهة برمجة التطبيقات.
التقارير والمستخدمون والمشاهدات (الملفات الشخصية)
قبل أن يتمكّن المستخدمون من استخدام تطبيقك لطلب بيانات التقارير من ملف شخصي (ملف شخصي)، عليك تنفيذ ما يلي:
- تفعيل واجهة برمجة تطبيقات "إحصاءات Google"
- أنشئ بيانات اعتماد لتطبيقك للوصول إلى واجهة برمجة التطبيقات.
- أدخِل بيانات الاعتماد في تطبيقك.
عند استخدام تطبيقك لطلب بيانات التقارير، يجب على المستخدمين منح الإذن بالوصول إلى البيانات نيابةً عنهم.
يتم تحديد الملف الشخصي من خلال رقم تعريف الملف الشخصي. تشكّل الملفّات الشخصية، من بين كيانات أخرى، جزءًا من التدرّج الهرمي للحسابات والمستخدمين والمواقع والملفات الشخصية في "إحصاءات Google". يمكن أن يستخدم تطبيقك Management API لاجتياز هذا التدرج الهرمي والحصول على ملف شخصي.
طلب البحث عن السمات والمقاييس
يمكنك إجراء طلب بحث في واجهة برمجة التطبيقات لبيانات تقارير "إحصاءات Google"، والتي تتكوّن من سمات ومقاييس. المقاييس هي المقاييس الفردية لنشاط المستخدم، مثل عدد المستخدمين النشطين على الموقع في الوقت الحالي. تُقسِّم السمات المقاييس على بعض المعايير الشائعة مثل مصادر الزيارات والموقع الجغرافي ومعلومات الصفحة وما إلى ذلك.
استخدِم الدليل المرجعي للسمات والمقاييس لاستكشاف جميع السمات والمقاييس [المستندة إلى العرض] المتاحة لواجهة برمجة التطبيقات. يمكنك أيضًا الاطّلاع على الدليل المرجعي لواجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي لمعرفة كيفية تحديد السمات والمقاييس في طلب بحث لواجهة برمجة التطبيقات.
العمل مع التقارير
يمكن اعتبار البيانات التي يتم عرضها من واجهة برمجة التطبيقات على أنّها جدول يحتوي على عنوان وقائمة من الصفوف. وتتألف كل استجابة من واجهة برمجة التطبيقات من عنوان يصف اسم كل عمود ونوع بياناته. وتحتوي الاستجابة أيضًا على قائمة بالصفوف، حيث يكون كل صف عبارة عن قائمة بالخلايا التي تحتوي على بيانات بالترتيب نفسه الذي يتضمّن العناوين. يمكنك الاطّلاع على الدليل المرجعي لواجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي للحصول على مزيد من المعلومات حول استجابة واجهة برمجة التطبيقات.
سياسة الحصص
تعالج واجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي الملايين من عمليات طلبات البيانات. نحن نستخدم نظام حصص لحماية النظام من تلقّي عمليات أكثر مما يمكنه التعامل معها، ولضمان التوزيع العادل لموارد النظام. لمعرفة مزيد من التفاصيل، يمكنك قراءة دليل الحدود والحصص.
الخطوات التالية
والآن بعد أن فهمت طريقة عمل واجهة برمجة التطبيقات، للبدء:
- يمكنك قراءة دليل المطوّر للتعرّف على كيفية استخدام واجهة برمجة التطبيقات.
- يمكنك الاطّلاع على الدليل المرجعي للسمات والمقاييس للحصول على قائمة بجميع البيانات المتاحة من خلال واجهة برمجة التطبيقات.
- يمكنك مراجعة صفحة المكتبات والنماذج للاطّلاع على قائمة بجميع مكتبات العملاء المتاحة التي يمكنك استخدامها مع واجهة برمجة التطبيقات.