Возвращает настроенный отчет о записях доступа к данным. В отчете представлены записи каждый раз, когда пользователь читает данные отчетов Google Analytics. Записи о доступе хранятся до 2 лет.
Для объекта можно запросить отчеты о доступе к данным. Отчеты можно запрашивать для любого ресурса, однако параметры, не связанные с квотой, можно запрашивать только для ресурсов Google Analytics 360. Этот метод доступен только администраторам.
Эти записи доступа к данным включают в себя отчеты пользовательского интерфейса GA4, исследования пользовательского интерфейса GA4, API данных GA4 и другие продукты, такие как Firebase и Admob, которые могут получать данные из Google Analytics посредством связи. Эти записи не включают изменения конфигурации свойства, такие как добавление потока или изменение часового пояса свойства. Историю изменений конфигурации см. в разделе searchChangeHistoryEvents .
HTTP-запрос
POST https://analyticsadmin.googleapis.com/v1alpha/{entity=accounts/*}:runAccessReport
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
entity | Отчет о доступе к данным поддерживает запросы на уровне ресурса или аккаунта. Если это запрошено на уровне аккаунта, отчеты о доступе к данным включают весь доступ ко всем ресурсам под этим аккаунтом. Чтобы запросить на уровне ресурса, объект должен иметь вид, например, «properties/123», если «123» — это идентификатор вашего ресурса GA4. Чтобы запросить на уровне учетной записи, сущность должна быть, например, «accounts/1234», если «1234» — это идентификатор вашей учетной записи GA4. |
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{ "dimensions": [ { object ( |
Поля | |
---|---|
dimensions[] | Размеры, запрошенные и отображенные в ответе. Запросы могут иметь до 9 измерений. |
metrics[] | Метрики, запрошенные и отображаемые в ответе. Запросы разрешены до 10 метрик. |
dateRanges[] | Диапазоны дат записей доступа для чтения. Если запрошено несколько диапазонов дат, каждая строка ответа будет содержать индекс диапазона дат, отсчитываемый от нуля. Если два диапазона дат перекрываются, записи доступа для перекрывающихся дней включаются в строки ответа для обоих диапазонов дат. Запросы разрешены до двух диапазонов дат. |
dimensionFilter | Фильтры измерений позволяют ограничить ответ отчета определенными значениями измерений, которые соответствуют фильтру. Например, фильтрация записей доступа одного пользователя. Дополнительные сведения см. в разделе «Основы фильтров измерений» . В этом фильтре нельзя использовать метрики. |
metricFilter | Фильтры метрик позволяют ограничить ответ отчета определенными значениями метрик, которые соответствуют фильтру. Фильтры метрик применяются после агрегирования строк отчета, аналогично оператору «have» в SQL. В этом фильтре нельзя использовать размеры. |
offset | Количество строк в начальной строке. Первая строка считается строкой 0. Если смещение не указано, оно рассматривается как 0. Если смещение равно нулю, этот метод вернет первую страницу результатов с Дополнительные сведения об этом параметре нумерации страниц см. в разделе Нумерация страниц . |
limit | Количество возвращаемых строк. Если не указано, возвращается 10 000 строк. API возвращает максимум 100 000 строк на запрос, независимо от того, сколько вы запрашиваете. API может вернуть меньше строк, чем запрошенное Дополнительные сведения об этом параметре нумерации страниц см. в разделе Нумерация страниц . |
timeZone | Часовой пояс этого запроса, если он указан. Если не указано, используется часовой пояс объекта. Часовой пояс запроса используется для интерпретации дат начала и окончания отчета. Отформатировано как строки из базы данных часовых поясов IANA ( https://www.iana.org/time-zones) ; например «Америка/Нью-Йорк» или «Азия/Токио». |
orderBys[] | Указывает, как упорядочены строки в ответе. |
returnEntityQuota | Переключает, возвращать ли текущее состояние квоты этого ресурса Google Analytics. Квота возвращается в AccessQuota . Для запросов на уровне учетной записи это поле должно быть ложным. |
includeAllUsers | Необязательный. Определяет, включать ли в ответ пользователей, которые никогда не совершали вызов API. Если значение равно true, в ответ включаются все пользователи, имеющие доступ к указанному ресурсу или учетной записи, независимо от того, выполнили ли они вызов API или нет. Если значение равно false, будут включены только пользователи, выполнившие вызов API. |
expandGroups | Необязательный. Решает, следует ли возвращать пользователей в группы пользователей. Это поле работает только в том случае, если для параметра includeAllUsers установлено значение true. Если это правда, он вернет всех пользователей, имеющих доступ к указанному ресурсу или учетной записи. Если false, будут возвращены только пользователи с прямым доступом. |
Тело ответа
В случае успеха тело ответа содержит экземпляр RunAccessReportResponse
.
Области авторизации
Требуется одна из следующих областей OAuth:
-
https://www.googleapis.com/auth/analytics.readonly
-
https://www.googleapis.com/auth/analytics.edit