Method: properties.batchRunPivotReports

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

طلب HTTP

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

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

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

المَعلمات
property

string

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

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

نص الطلب

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

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

object (RunPivotReportRequest)

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

نص الاستجابة

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

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

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

object (RunPivotReportResponse)

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

string

لتحديد نوع المورد لهذه الرسالة. ويكون kind دائمًا هو السلسلة الثابتة "analyticsData#batchRunPivotReporting". يفيد في التمييز بين أنواع الاستجابة في JSON.

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

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

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

طلب تغيير محوري للطلب

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

تمثيل JSON 
{
  "property": string,
  "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
}
الحقول
property

string

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

مثال: الخصائص/1234
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.