Method: properties.batchRunPivotReports

Возвращает несколько сводных отчетов в пакете. Все отчеты должны относиться к одному и тому же ресурсу GA4.

HTTP-запрос

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

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
property

string

Идентификатор ресурса Google Analytics GA4, события которого отслеживаются. Указывается в URL-пути, а не в теле. Чтобы узнать больше, посмотрите , где найти свой идентификатор объекта . Это свойство необходимо указать для пакета. Свойство в RunPivotReportRequest может быть неопределенным или соответствовать этому свойству.

Пример: свойства/1234

Тело запроса

Тело запроса содержит данные следующей структуры:

JSON-представление
{
  "requests": [
    {
      object (RunPivotReportRequest)
    }
  ]
}
Поля
requests[]

object ( RunPivotReportRequest )

Индивидуальные запросы. Каждый запрос имеет отдельный ответ сводного отчета. В каждом пакетном запросе допускается до 5 запросов.

Тело ответа

Пакетный ответ, содержащий несколько сводных отчетов.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление
{
  "pivotReports": [
    {
      object (RunPivotReportResponse)
    }
  ],
  "kind": string
}
Поля
pivotReports[]

object ( RunPivotReportResponse )

Индивидуальные ответы. Каждый ответ имеет отдельный запрос сводного отчета.

kind

string

Определяет, к какому типу ресурса относится это сообщение. Этот kind всегда представляет собой фиксированную строку «analyticsData#batchRunPivotReports». Полезно различать типы ответов в JSON.

Области авторизации

Требуется одна из следующих областей OAuth:

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

ЗапуститьPivotReportRequest

Запрос на создание сводного отчета.

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 Analytics GA4, события которого отслеживаются. Указывается в URL-пути, а не в теле. Чтобы узнать больше, посмотрите , где найти свой идентификатор объекта . В пакетном запросе это свойство должно быть либо неопределенным, либо соответствовать свойству уровня пакета.

Пример: свойства/1234

dimensions[]

object ( Dimension )

Запрошенные размеры. Все определенные измерения должны использоваться одним из следующих элементов: DimensionExpression, DimensionFilter, Pivots, OrderBys.

metrics[]

object ( Metric )

Запрошенные метрики. Необходимо указать хотя бы одну метрику. Все определенные метрики должны использоваться одним из следующих: metric_expression, metricFilter, orderBys.

dateRanges[]

object ( DateRange )

Диапазон дат для получения данных о событиях для отчета. Если указано несколько диапазонов дат, в отчете используются данные о событиях из каждого диапазона дат. В имена полей сводной таблицы можно включить специальное измерение с именем поля dateRange; если он включен, в отчете сравниваются диапазоны дат. В запросе когорты этот dateRanges не должен быть указан.

pivots[]

object ( Pivot )

Описывает визуальный формат измерений отчета в столбцах или строках. Объединение полейNames (имен измерений) во всех сводных таблицах должно представлять собой подмножество имен измерений, определенных в разделе Измерения. Никакие две точки поворота не могут иметь одно и то же измерение. Измерение отображается только в том случае, если оно отображается в центре.

dimensionFilter

object ( FilterExpression )

Предложение фильтра измерений. Для использования в этом фильтре необходимо запросить размеры. В этом фильтре нельзя использовать метрики.

metricFilter

object ( FilterExpression )

Предложение фильтра метрик. Применяется на этапе после агрегирования, аналогично предложению «имеет» в SQL. Метрики должны быть запрошены для использования в этом фильтре. В этом фильтре нельзя использовать размеры.

currencyCode

string

Код валюты в формате ISO4217, например «AED», «USD», «JPY». Если поле пусто, в отчете используется валюта ресурса по умолчанию.

cohortSpec

object ( CohortSpec )

Когортная группа, связанная с этим запросом. Если в запросе есть когортная группа, параметр «когорта» должен присутствовать.

keepEmptyRows

boolean

Если значение false или не указано, каждая строка со всеми метриками, равными 0, не будет возвращена. Если это правда, эти строки будут возвращены, если они не будут удалены фильтром отдельно.

Независимо от этого параметра keepEmptyRows , в отчете могут отображаться только данные, записанные свойством Google Analytics (GA4).

Например, если свойство никогда не регистрирует событие purchase , то запрос для измерения eventName и метрики eventCount не будет содержать строки eventName: «purchase» и eventCount: 0.

returnPropertyQuota

boolean

Переключает, возвращать ли текущее состояние квоты этого ресурса Google Analytics. Квота возвращается в PropertyQuota .