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