يعرض تقريرًا مخصّصًا لبيانات الأحداث في الوقت الفعلي لموقعك. تظهر الأحداث في تقارير الوقت الفعلي بعد ثوانٍ من إرسالها إلى "إحصاءات 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_(تجميع المقاييس)". |
orderBys[] |
تحدّد هذه السمة كيفية ترتيب الصفوف في الاستجابة. |
returnPropertyQuota |
تبديل ما إذا كان سيتم عرض الحالة الحالية لحصة "الوقت الفعلي" لهذا الموقع على "إحصاءات Google". يتم عرض الحصة في PropertyQuota. |
minuteRanges[] |
نطاقات الدقائق لبيانات الحدث المطلوب قراءتها. وفي حال عدم تحديد ذلك، سيتم استخدام نطاق دقيقة واحدة لآخر 30 دقيقة. في حال طلب نطاقات دقائق متعددة، سيحتوي كل صف للاستجابة على فهرس نطاق دقائق يستند إلى صفر. إذا تداخلت نطاقات دقيقتين، يتم تضمين بيانات الحدث للدقائق المتداخلة في صفوف الاستجابة لكلا نطاقي الدقائق. |
نص الاستجابة
جدول تقرير الاستجابة في الوقت الفعلي المقابل لأحد الطلبات
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "dimensionHeaders": [ { object ( |
الحقول | |
---|---|
dimensionHeaders[] |
لوصف أعمدة الأبعاد. يتطابق عدد AttributeHeaders وترتيب AttributeHeaders مع السمات المتوفّرة في الصفوف. |
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 |
دقيقة النهاية الشاملة لطلب البحث كعدد من الدقائق قبل الآن. لا يمكن أن يقع قبل وفي حال عدم تحديد قيمة، يتم ضبط القيمة التلقائية لـ |