Method: batchRunPivotReports

تعرض تقارير محورية متعددة في دفعة واحدة. يجب أن تكون جميع التقارير لنفس "الكيان".

طلب HTTP

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

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

نص الطلب

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

تمثيل JSON 
{
  "entity": {
    object (Entity)
  },
  "requests": [
    {
      object (RunPivotReportRequest)
    }
  ]
}
الحقول
entity

object (Entity)

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

object (RunPivotReportRequest)

الطلبات الفردية. لكل طلب استجابة منفصلة للتقرير المحوري. يُسمح لكل طلب مُجمَّع بما يصل إلى 5 طلبات.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

الرد المجمّع الذي يحتوي على عدة تقارير محورية.

تمثيل JSON 
{
  "pivotReports": [
    {
      object (RunPivotReportResponse)
    }
  ]
}
الحقول
pivotReports[]

object (RunPivotReportResponse)

الردود الفردية. كل رد له طلب تقرير محوري منفصل.

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

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

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

RunPivotReportRequest

طلب إنشاء تقرير محوري.

تمثيل 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)

السمات المطلوبة. يجب استخدام جميع السمات المحدّدة باستخدام إحدى السمات التالية: sampleExpression وdimensionFilter والمحوري وorderBys.
metrics[]

object (Metric)

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

object (FilterExpression)

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

object (FilterExpression)

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

object (Pivot)

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

object (DateRange)

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

string

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

object (CohortSpec)

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

boolean

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

boolean

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