يعرض تقريرًا مخصّصًا لبيانات الأحداث في الوقت الفعلي لموقعك. تظهر الأحداث في تقارير الوقت الفعلي بعد ثوانٍ من إرسالها إلى "إحصاءات Google". تعرِض تقارير "الوقت الفعلي" الأحداث وبيانات الاستخدام لفترات زمنية تتراوح بين الوقت الحالي و30 دقيقة قبل (ما يصل إلى 60 دقيقة لمواقع "إحصاءات Google 360").
للحصول على دليل لإنشاء طلبات في الوقت الفعلي وفهم الردود، يمكنك الاطّلاع على مقالة إنشاء تقرير في الوقت الفعلي.
طلب HTTP
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runRealtimeReport
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
property |
معرّف موقع على "إحصاءات Google 4" يتم تتبُّع أحداثه. يتم تحديده في مسار عنوان URL وليس في النص الأساسي. للمزيد من المعلومات، اطّلِع على مكان العثور على رقم تعريف الموقع. مثال: Property/1234 |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "dimensions": [ { object ( |
الحقول | |
---|---|
dimensions[] |
السمات المطلوبة وعرضها. |
metrics[] |
المقاييس المطلوبة وعرضها. |
dimensionFilter |
عبارة الفلتر للسمات. لا يمكن استخدام المقاييس في هذا الفلتر. |
metricFilter |
عبارة فلتر المقاييس تُطبق في مرحلة ما بعد التجميع، على غرار استخدام عبارة SQL (لغة الاستعلام البنيوية). لا يمكن استخدام السمات في هذا الفلتر. |
limit |
عدد الصفوف المطلوب عرضها. وفي حال عدم تحديد قيمة، يتم عرض 10,000 صف. تعرض واجهة برمجة التطبيقات 250,000 صف كحد أقصى لكل طلب، بغض النظر عن العدد الذي تطلبه. يجب أن تكون قيمة الحقل " ويمكن أن تعرِض واجهة برمجة التطبيقات أيضًا صفوفًا أقل من قيمة |
metricAggregations[] |
تجميع المقاييس سيتمّ عرض قيم المقاييس المجمَّعة في الصفوف التي يتم فيها ضبط قيم السمة على "RESERVED_(MetricAggregation)". |
orderBys[] |
لتحديد كيفية ترتيب الصفوف في الاستجابة. |
returnPropertyQuota |
تبديل ما إذا كان سيتم عرض الحالة الحالية للحصة في الوقت الفعلي لهذا الموقع على "إحصاءات Google". يتم عرض الحصة في PropertyQuota. |
minuteRanges[] |
نطاقات الدقائق لبيانات الأحداث المطلوب قراءتها. وفي حال عدم تحديد ذلك، سيتم استخدام نطاق دقيقة واحدة لآخر 30 دقيقة. إذا تم طلب نطاقات دقائق متعددة، سيحتوي كل صف للاستجابة على فهرس نطاق دقائق يستند إلى صفر. إذا تداخلت نطاقات دقيقتين، يتم تضمين بيانات الأحداث للدقائق المتداخلة في صفوف الاستجابة لكلا نطاقي الدقائق. |
نص الاستجابة
جدول تقرير الوقت الفعلي للاستجابة والمقابل لطلب معيّن.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "dimensionHeaders": [ { object ( |
الحقول | |
---|---|
dimensionHeaders[] |
لوصف أعمدة الأبعاد. يتطابق عدد أبعاد الأبعاد وترتيب أبعادها مع السمات الموجودة في الصفوف. |
metricHeaders[] |
لوصف أعمدة المقاييس. يتطابق عدد MetricHeaders وترتيبها MetricHeaders في المقاييس الموجودة في الصفوف. |
rows[] |
صفوف مجموعات قيم السمات وقيم المقاييس في التقرير |
totals[] |
القيم الإجمالية للمقاييس عند طلبها. |
maximums[] |
الحد الأقصى لقيم المقاييس، عند الطلب. |
minimums[] |
تمثّل هذه السمة الحد الأدنى لقيم المقاييس، عند الطلب. |
rowCount |
إجمالي عدد الصفوف في نتيجة طلب البحث. وتكون |
propertyQuota |
حالة الحصة في الوقت الفعلي لهذا الموقع على "إحصاءات Google"، بما في ذلك هذا الطلب. |
kind |
تحدّد نوع المورد الذي تصل إليه هذه الرسالة. تمثّل |
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
MinuteRange
مجموعة من الدقائق متجاورة: startMinutesAgo
، startMinutesAgo + 1
، ...، endMinutesAgo
. يُسمح للطلبات التي تصل مدتها إلى دقيقتَين.
تمثيل JSON |
---|
{ "name": string, "startMinutesAgo": integer, "endMinutesAgo": integer } |
الحقول | |
---|---|
name |
يعيّن اسمًا لنطاق الدقائق هذا. وتتم قيمة السمة " |
startMinutesAgo |
دقيقة البدء الشاملة لطلب البحث كعدد من الدقائق قبل الآن. على سبيل المثال، تحدّد السمة وفي حال عدم تحديد قيمة، يتم ضبط السمة |
endMinutesAgo |
دقيقة النهاية الشاملة لطلب البحث كعدد من الدقائق قبل الآن. لا يمكن أن يقع قبل وفي حال عدم تحديد قيمة، يتم ضبط السمة |