Method: runPivotReport

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

طلب HTTP

POST https://analyticsdata.googleapis.com/v1alpha:runPivotReport

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "entity": {
    object (Entity)
  },
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "pivots": [
    {
      object (Pivot)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "returnPropertyQuota": boolean
}
الحقول
entity

object (Entity)

الموقع الذي يتم تتبُّع أحداثه. وفي الطلب المجمّع، يجب أن يكون هذا الكيان غير محدّد أو متسقًا مع الكيان على مستوى الدفعة.
dimensions[]

object (Dimension)

السمات المطلوبة. يجب استخدام جميع الأبعاد المحدَّدة بواسطة أحد العناصر التالية: dimensionExpression وdimensionFilter وPivots وorderBys.
metrics[]

object (Metric)

المقاييس المطلوبة، يجب تحديد مقياس واحد على الأقل. يجب استخدام جميع المقاييس المحدَّدة بواسطة أحد الأنواع التالية: Metrics_expression وMetricFilter وorderBys.
dimensionFilter

object (FilterExpression)

عبارة الفلتر للأبعاد. يجب طلب استخدام المكوّنات في هذا الفلتر. لا يمكن استخدام المقاييس في هذا الفلتر.
metricFilter

object (FilterExpression)

عبارة تصفية المقاييس. يُطبق في مرحلة ما بعد التجميع، على غرار وجود عبارة SQL. يجب طلب استخدام المقاييس في هذا الفلتر. لا يمكن استخدام الأبعاد في هذا الفلتر.
pivots[]

object (Pivot)

يصف التنسيق المرئي لأبعاد التقرير في الأعمدة أو الصفوف. يجب أن يكون اتحاد fieldNames (أسماء السمات) في جميع النقاط المحورية مجموعة فرعية من أسماء السمات المحددة في "الأبعاد". لا يمكن أن يتشارك أي محوريَين في أحد السمات. لا تظهر السمة إلا إذا ظهرت في شكل محوري.
dateRanges[]

object (DateRange)

النطاق الزمني المطلوب من أجل استرداد بيانات الأحداث للتقرير. في حال تحديد نطاقات زمنية متعددة، يتم استخدام بيانات الأحداث من كل نطاق زمني في التقرير. بُعد خاص يحمل اسم الحقل "dateRange" يمكن تضمينها في أسماء حقول المحور المحوري؛ في حال تضمينه، يقارن التقرير بين النطاقات الزمنية. في طلب المجموعة النموذجية، يجب عدم تحديد قيمة dateRanges هذه.
currencyCode

string

رمز عملة بتنسيق ISO4217، مثل "AED" و"USD" و"JPY". إذا كان الحقل فارغًا، يستخدم التقرير العملة التلقائية للكيان.
cohortSpec

object (CohortSpec)

المجموعة النموذجية المرتبطة بهذا الطلب. إذا كانت هناك مجموعة نموذجية في الطلب، تحتوي "المجموعة النموذجية" أن يكون متوفرًا.
keepEmptyRows

boolean

إذا كانت القيمة "خطأ" أو "غير محدّدة"، لن يتم عرض كل صف يحتوي على جميع المقاييس التي تساوي 0. إذا كانت القيمة true، فسيتم عرض هذه الصفوف إذا لم تتم إزالتها بشكل منفصل بواسطة عامل تصفية.
returnPropertyQuota

boolean

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

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال RunPivotReportResponse.

نطاقات التفويض

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics