نظرة عامة

يوضّح هذا المستند واجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي لخدمة "إحصاءات Google". للاطّلاع على مرجع تفصيلي حول واجهة برمجة التطبيقات، يمكنك قراءة مرجع واجهة برمجة التطبيقات.

مقدمة

تتيح لك واجهة "واجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي" طلب بيانات في الوقت الفعلي لمستخدم تمت مصادقته، مثل النشاط في الوقت الفعلي على موقعك.

يمكنك استخدام واجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي من أجل:

  • اعرض المشاهدين النشطين لصفحة معيّنة وقدِّم لهم شعورًا بالإلحاح عند مشاهدة سلعة ذات مستودع محدود.
  • عرض المحتوى الأكثر رواجًا، مثل أهم 10 صفحات نشطة
  • إنشاء لوحة بيانات في الوقت الفعلي وعرضها

الخادم الوكيل الفائق لخدمة "إحصاءات Google"

استخدِم SuperProxy في "إحصاءات Google" للتعامل مع العديد من تفاصيل تنفيذ واجهات برمجة تطبيقات "إحصاءات Google" من خلال المصادقة والتخزين المؤقت وتحويل ردود واجهة برمجة التطبيقات إلى التنسيقات المستخدَمة مباشرةً مع مكتبات العروض المرئية والرسومات البيانية.

نظرة عامة على المفاهيم

وفي ما يلي المفاهيم الأساسية لواجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي:

  • علاقة التقارير بالمستخدمين والمشاهدات (الملفات الشخصية)
  • هيكل التقرير وكيفية إنشاء طلبات البحث.
  • يتم العمل على الردّ من واجهة برمجة التطبيقات.

التقارير والمستخدمون والمشاهدات (الملفات الشخصية)

قبل أن يتمكّن المستخدمون من استخدام تطبيقك لطلب بيانات التقارير من طريقة عرض (ملف شخصي)، يجب عليك:

  1. تفعيل واجهة برمجة تطبيقات "إحصاءات Google"
  2. أنشئ بيانات اعتماد لتطبيقك للوصول إلى واجهة برمجة التطبيقات.
  3. ضع بيانات الاعتماد في تطبيقك.

عند استخدام تطبيقك لطلب بيانات التقرير، يجب على المستخدمين منح الإذن بالوصول إلى البيانات نيابةً عنهم.

يتم تحديد الملف الشخصي من خلال رقم تعريف الملف الشخصي. تشكّل الملفات الشخصية (الملفات الشخصية)، من بين كيانات أخرى، جزءًا من التدرّج الهرمي للحسابات والمستخدمين والمواقع والملفات الشخصية في "إحصاءات Google". يمكن لتطبيقك استخدام Management API لاجتياز هذا العرض الهرمي والحصول على ملف شخصي.

طلب البحث عن السمات والمقاييس

يمكنك إجراء طلبات بحث عن بيانات تقارير واجهة برمجة التطبيقات في "إحصاءات Google"، والتي تتكوّن من سمات ومقاييس. المقاييس هي مقاييس فردية لنشاط المستخدم، مثل عدد المستخدمين النشطين على الموقع في الوقت الحالي. وتُقسِّم السمات المقاييس على مستوى بعض المعايير الشائعة، مثل مصادر الزيارات والموقع الجغرافي ومعلومات الصفحة وما إلى ذلك.

يمكنك استخدام الدليل المرجعي للمقاييس والسمات لاستكشاف جميع السمات والمقاييس [المعروضة] المتاحة لواجهة برمجة التطبيقات. يمكنك أيضًا الاطّلاع على الدليل المرجعي لواجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي للتعرّف على طريقة تحديد السمات والمقاييس في طلب بحث واجهة برمجة التطبيقات.

التعامل مع التقارير

إنّ البيانات التي يتم عرضها من واجهة برمجة التطبيقات يمكن اعتبارها جدولًا يحتوي على عنوان وقائمة من الصفوف. وتتألّف كل استجابة من واجهة برمجة التطبيقات من عنوان يصف اسم كل عمود ونوع بياناته. وتحتوي الاستجابة أيضًا على قائمة بالصفوف، حيث يمثّل كل صف قائمة بالخلايا التي تحتوي على بيانات بنفس ترتيب العناوين. يمكنك قراءة الدليل المرجعي لواجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي للحصول على مزيد من المعلومات عن استجابة واجهة برمجة التطبيقات.

سياسة الحصص

تُعالج واجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي الملايين من عمليات طلبات البيانات. نحن نستخدم نظام حصة لحماية النظام من تلقي عمليات أكثر مما يمكنه التعامل معه، ولضمان التوزيع العادل لموارد النظام. لمزيد من التفاصيل، يُرجى قراءة دليل الحدود والحصص.

الخطوات التالية

بعد أن فهمت طريقة عمل واجهة برمجة التطبيقات، للبدء، اتّبِع الخطوات التالية: