تعرض تقريرًا مخصّصًا ببيانات الأحداث في الوقت الفعلي لموقعك. وتظهر الأحداث في تقارير الوقت الفعلي بعد ثوانٍ من إرسالها إلى "إحصاءات Google". تعرِض تقارير "الوقت الفعلي" الأحداث وبيانات الاستخدام لفترات زمنية تتراوح بين الوقت الحالي وقبل 30 دقيقة (ما يصل إلى 60 دقيقة لمواقع "إحصاءات Google 360").
لدليل إنشاء طلبات في الوقت الفعلي لفهم الردود، يمكنك الاطّلاع على إنشاء تقرير "الوقت الفعلي".
طلب HTTP
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runRealtimeReport
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
property |
معرّف موقع على "إحصاءات Google 4" يتم تتبُّع أحداثه. يتم تحديده في مسار عنوان URL وليس في النص الأساسي لمزيد من المعلومات، اطّلِع على مكان العثور على رقم تعريف الموقع. مثال: المواقع الإلكترونية/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[] |
يصف أعمدة السمات. يتطابق عدد DimensionHeaders وترتيب DimensionHeaders مع السمات الموجودة في الصفوف. |
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 |
دقيقة البدء الشاملة للاستعلام كعدد من الدقائق قبل الآن. على سبيل المثال، يحدِّد وفي حال عدم تحديد قيمة هذه السمة، يتم ضبط القيمة التلقائية على القيمة 29 للسمة |
endMinutesAgo |
دقيقة النهاية الشاملة للاستعلام كعدد من الدقائق قبل الآن. لا يمكن أن يقع ذلك قبل في حال عدم تحديد قيمة |