- HTTP-запрос
- Параметры пути
- Тело запроса
- Тело ответа
- Области авторизации
- ЗапуститьPivotReportRequest
- Попробуйте!
Возвращает несколько сводных отчетов в пакете. Все отчеты должны относиться к одному и тому же ресурсу GA4.
HTTP-запрос
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:batchRunPivotReports
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
property | Идентификатор ресурса Google Analytics GA4, события которого отслеживаются. Указывается в URL-пути, а не в теле. Чтобы узнать больше, посмотрите , где найти свой идентификатор объекта . Это свойство необходимо указать для пакета. Свойство в RunPivotReportRequest может быть неопределенным или соответствовать этому свойству. Пример: свойства/1234 |
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{
"requests": [
{
object ( |
Поля | |
---|---|
requests[] | Индивидуальные запросы. Каждый запрос имеет отдельный ответ сводного отчета. В каждом пакетном запросе допускается до 5 запросов. |
Тело ответа
Пакетный ответ, содержащий несколько сводных отчетов.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{
"pivotReports": [
{
object ( |
Поля | |
---|---|
pivotReports[] | Индивидуальные ответы. Каждый ответ имеет отдельный запрос сводного отчета. |
kind | Определяет, к какому типу ресурса относится это сообщение. Этот |
Области авторизации
Требуется одна из следующих областей OAuth:
-
https://www.googleapis.com/auth/analytics.readonly
-
https://www.googleapis.com/auth/analytics
ЗапуститьPivotReportRequest
Запрос на создание сводного отчета.
JSON-представление |
---|
{ "property": string, "dimensions": [ { object ( |
Поля | |
---|---|
property | Идентификатор ресурса Google Analytics GA4, события которого отслеживаются. Указывается в URL-пути, а не в теле. Чтобы узнать больше, посмотрите , где найти свой идентификатор объекта . В пакетном запросе это свойство должно быть либо неопределенным, либо соответствовать свойству уровня пакета. Пример: свойства/1234 |
dimensions[] | Запрошенные размеры. Все определенные измерения должны использоваться одним из следующих элементов: DimensionExpression, DimensionFilter, Pivots, OrderBys. |
metrics[] | Запрошенные метрики. Необходимо указать хотя бы одну метрику. Все определенные метрики должны использоваться одним из следующих: metric_expression, metricFilter, orderBys. |
dateRanges[] | Диапазон дат для получения данных о событиях для отчета. Если указано несколько диапазонов дат, в отчете используются данные о событиях из каждого диапазона дат. В имена полей сводной таблицы можно включить специальное измерение с именем поля dateRange; если он включен, в отчете сравниваются диапазоны дат. В запросе когорты этот |
pivots[] | Описывает визуальный формат измерений отчета в столбцах или строках. Объединение полейNames (имен измерений) во всех сводных таблицах должно представлять собой подмножество имен измерений, определенных в разделе Измерения. Никакие две точки поворота не могут иметь одно и то же измерение. Измерение отображается только в том случае, если оно отображается в центре. |
dimensionFilter | Предложение фильтра измерений. Для использования в этом фильтре необходимо запросить размеры. В этом фильтре нельзя использовать метрики. |
metricFilter | Предложение фильтра метрик. Применяется на этапе после агрегирования, аналогично предложению «имеет» в SQL. Метрики должны быть запрошены для использования в этом фильтре. В этом фильтре нельзя использовать размеры. |
currencyCode | Код валюты в формате ISO4217, например «AED», «USD», «JPY». Если поле пусто, в отчете используется валюта ресурса по умолчанию. |
cohortSpec | Когортная группа, связанная с этим запросом. Если в запросе есть когортная группа, параметр «когорта» должен присутствовать. |
keepEmptyRows | Если значение false или не указано, каждая строка со всеми метриками, равными 0, не будет возвращена. Если это правда, эти строки будут возвращены, если они не будут удалены фильтром отдельно. Независимо от этого параметра Например, если свойство никогда не регистрирует событие |
returnPropertyQuota | Переключает, возвращать ли текущее состояние квоты этого ресурса Analytics. Квота возвращается в PropertyQuota . |
comparisons[] | Необязательный. Конфигурация сравнений запрошена и отображена. Для запроса требуется как поле сравнения, так и измерение сравнения, чтобы получить столбец сравнения в ответе. |