Method: properties.runPivotReport

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

طلب HTTP

POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runPivotReport

يستخدم عنوان URL بنية gRPC Transcoding.

معلّمات المسار

المَعلمات
property

string

معرّف موقع "إحصاءات Google" 4 الذي يتم تتبّع أحداثه. يتم التحديد في مسار عنوان URL وليس النص. ولمزيد من المعلومات، اطّلِع على مكان العثور على رقم تعريف موقعك. ضمن طلب مجمّع، يجب أن تكون هذه السمة غير محدّدة أو غير متوافقة مع الموقع الإلكتروني على مستوى المجموعة.

مثال: الخصائص/1234

نص الطلب

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

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

object (Dimension)

الأبعاد المطلوبة. يجب استخدام كلّ الأبعاد المحدّدة بواسطة أحد المكوّنات التالية: dimension Expression وdimensionfilter وhubs و orderBys.
metrics[]

object (Metric)

المقاييس المطلوبة، يلزم تحديد مقياس واحد على الأقل. يجب استخدام كل المقاييس المحدّدة بواسطة أحد العناصر التالية: Statement_expression، وMetricMetric، وOrderBys.
dateRanges[]

object (DateRange)

النطاق الزمني لاسترداد بيانات الحدث للتقرير. وإذا تم تحديد نطاقات زمنية متعددة، سيتم استخدام بيانات الأحداث من كل نطاق زمني في التقرير. يمكن تضمين بُعد خاص باسم حقل "و في طلب المجموعة النموذجية، يجب عدم تحديد dateRanges.
pivots[]

object (Pivot)

يصف التنسيق المرئي لسمات التقرير في الأعمدة أو الصفوف. يجب أن يكون اتحاد أسماء الحقول (أسماء الأبعاد) في جميع المحاور الفرعية مجموعة فرعية من أسماء السمات المحدّدة في "الأبعاد". لا يمكن أن يشارك محوران رئيسيان سمة. لا يمكن رؤية أي بُعد إلا إذا ظهر في محور.
dimensionFilter

object (FilterExpression)

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

object (FilterExpression)

عبارة عن مقاييس الفلتر. يتم تطبيقه في مرحلة بعد التجميع، على غرار عبارة SQL. يجب طلب المقاييس لاستخدامها في هذا الفلتر. لا يمكن استخدام الأبعاد في هذا الفلتر.
currencyCode

string

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

object (CohortSpec)

المجموعة النموذجية المرتبطة بهذا الطلب. إذا كانت هناك مجموعة نموذجية في الطلب، يجب أن تتوفّر السمة 'cohort'.
keepEmptyRows

boolean

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

boolean

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

نص الاستجابة

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

نطاقات الأذونات

يتطلّب أحد نطاقات OAuth التالية:

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