Method: properties.runPivotReport

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

طلب HTTP

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

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

مَعلمات المسار

المعلمات
property

string

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

مثال: properties/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,
  "comparisons": [
    {
      object (Comparison)
    }
  ]
}
الحقول
dimensions[]

object (Dimension)

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

object (Metric)

المقاييس المطلوبة، يجب تحديد مقياس واحد على الأقل. يجب استخدام جميع المقاييس المحدّدة من خلال أحد العناصر التالية: metric_expression وmetricFilter وorderBys.
dateRanges[]

object (DateRange)

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

object (Pivot)

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

object (FilterExpression)

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

object (FilterExpression)

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

string

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

object (CohortSpec)

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

boolean

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

بصرف النظر عن إعداد keepEmptyRows هذا، لا يمكن عرض سوى البيانات التي سجّلها موقع "إحصاءات Google" في التقرير.

على سبيل المثال، إذا لم يسجِّل موقع إلكتروني حدث purchase مطلقًا، لن يتضمّن طلب البحث للسمة eventName والمقياس eventCount صفًا باسم الحدث: "purchase" وعدد الأحداث: 0.
returnPropertyQuota

boolean

يتيح هذا الخيار التبديل بين عرض الحالة الحالية لحصة هذا الموقع على "إحصاءات Google" أو عدم عرضها. يتمّ عرض الحصّة في PropertyQuota.
comparisons[]

object (Comparison)

اختيارية: إعدادات المقارنات المطلوبة والمعروضة يتطلب الطلب حقل مقارنات وسمة مقارنات لتلقّي عمود مقارنة في الاستجابة.

نص الاستجابة

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

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

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

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