يعرض تقريرًا مخصّصًا لبيانات أحداثك على "إحصاءات Google". تحتوي التقارير على إحصاءات مستمدة من البيانات التي تم جمعها بواسطة رمز تتبّع "إحصاءات Google". والبيانات التي يتم عرضها من واجهة برمجة التطبيقات هي على شكل جدول يحتوي على أعمدة للسمات والمقاييس المطلوبة. المقاييس هي مقاييس فردية لنشاط المستخدِم على موقعك، مثل المستخدِمين النشطين أو عدد الأحداث. تُقسِّم السمات المقاييس على مستوى بعض المعايير الشائعة، مثل اسم البلد أو الحدث.
طلب HTTP
POST https://analyticsdata.googleapis.com/v1alpha:runReport
يستخدم عنوان URL بنية تحويل الترميز gRPC.
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON | |
---|---|
{ "entity": { object ( |
الحقول | |
---|---|
entity |
موقع يتم تتبُّع أحداثه. في الطلب المجمّع، يجب أن يكون هذا الكيان غير محدّد أو متوافقًا مع الكيان على مستوى المجموعة. |
dimensions[] |
السمات المطلوبة وعرضها. |
metrics[] |
المقاييس المطلوبة وعرضها. |
dateRanges[] |
النطاقات الزمنية للبيانات المطلوب قراءتها. في حال طلب نطاقات زمنية متعددة، سيحتوي كل صف للاستجابة على فهرس نطاق زمني يستند إلى صفر. في حال تداخل نطاقَين زمنيَين، يتم تضمين بيانات الأحداث للأيام المتداخلة في صفوف الردّ لكلا النطاقَين الزمنيَين. في طلب مجموعة نموذجية، يجب عدم تحديد قيمة |
offset |
عدد الصفوف في صف البداية. يتم احتساب الصف الأول على أنه الصف 0. |
limit |
عدد الصفوف المطلوب عرضها. في حال عدم تحديد المَعلمة |
metricAggregations[] |
تجميع المقاييس سيتمّ عرض قيم المقاييس المجمَّعة في الصفوف التي يتم فيها ضبط قيم السمة على "RESERVED_(MetricAggregation)". |
dimensionFilter |
عبارة الفلتر للسمات. يجب طلب استخدام الأبعاد في هذا الفلتر. لا يمكن استخدام المقاييس في هذا الفلتر. |
metricFilter |
عبارة فلتر المقاييس تُطبق في مرحلة ما بعد التجميع، على غرار استخدام عبارة SQL (لغة الاستعلام البنيوية). يجب طلب استخدام المقاييس في هذا الفلتر. لا يمكن استخدام السمات في هذا الفلتر. |
orderBys[] |
لتحديد كيفية ترتيب الصفوف في الاستجابة. |
currencyCode |
تمثّل هذه السمة رمز عملة بتنسيق ISO4217، مثل AED أو USD أو JPY. إذا كان هذا الحقل فارغًا، يستخدم التقرير العملة التلقائية للكيان. |
cohortSpec |
مجموعة مجموعات نموذجية مرتبطة بهذا الطلب. إذا كانت هناك مجموعة نموذجية في الطلب، يجب أن تتوفّر سمة "المجموعة النموذجية". |
keepEmptyRows |
وإذا كانت القيمة خاطئة أو غير محدّدة، لن يتم عرض كل صف يحتوي على جميع المقاييس تساوي 0. إذا كانت القيمة "صحيح"، سيتم عرض هذه الصفوف إذا لم تتم إزالتها بشكل منفصل من خلال فلتر. |
returnPropertyQuota |
تبديل ما إذا كان سيتم عرض الحالة الحالية لحصة موقع "إحصاءات Google" هذا. يتم عرض الحصة في PropertyQuota. |
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال RunReportResponse
.
نطاقات الأذونات
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics