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