Попробуйте сервер MCP для Google Analytics. Установите его с
GitHub и ознакомьтесь с
анонсом для получения более подробной информации.
Method: properties.reportingDataAnnotations.list
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Перечислите все аннотации к данным отчетов для свойства.
HTTP-запрос
GET https://analyticsadmin.googleapis.com/v1alpha/{parent=properties/*}/reportingDataAnnotations
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
| Параметры |
|---|
parent | string Необходимый. Имя ресурса свойства. Формат: свойства/property_id Пример: свойства/123 |
Параметры запроса
| Параметры |
|---|
filter | string Необязательный. Фильтр, ограничивающий список аннотаций к данным отчетов в родительском свойстве. Поддерживаемые поля: - 'имя'
-
title -
description -
annotationDate -
annotationDateRange -
color
Кроме того, этот API предоставляет следующие вспомогательные функции: - annotation_duration(): продолжительность, которую отмечает эта аннотация, длительность . ожидайте числовое представление секунд, за которым следует суффикс
s . - is_annotation_in_range(startDate, endDate) : если аннотация находится в диапазоне, указанном
startDate и endDate . Даты имеют формат ISO-8601, например 2031-06-28
Поддерживаемые операции: -
= : равно -
!= : не равно -
< : меньше чем -
> : больше, чем -
<= : меньше или равно -
>= : больше или равно -
: : имеет оператор -
=~ : совпадение с регулярным выражением -
!~ : регулярное выражение не соответствует -
NOT : Логичное «нет». -
AND : Логично и -
OR : Логическое или
Примеры: -
title="Holiday Sale" -
description=~"[Bb]ig [Gg]ame.*[Ss]ale" -
is_annotation_in_range("2025-12-25", "2026-01-16") = true -
annotation_duration() >= 172800s AND title:BOGO
|
pageSize | integer Необязательный. Максимальное количество возвращаемых ресурсов. Служба может вернуть меньшее значение, чем это, даже если есть дополнительные страницы. Если не указано, будет возвращено не более 50 ресурсов. Максимальное значение — 200; (более высокие значения будут приведены к максимуму) |
pageToken | string Необязательный. Токен страницы, полученный в результате предыдущего вызова reportingDataAnnotations.list . Предоставьте это, чтобы получить следующую страницу. При разбиении на страницы все остальные параметры, предоставленные в reportingDataAnnotations.list , должны соответствовать вызову, который предоставил токен страницы. |
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
Ответное сообщение для RPC ListReportingDataAnnotation.
В случае успеха тело ответа содержит данные следующей структуры:
| JSON-представление |
|---|
{
"reportingDataAnnotations": [
{
object (ReportingDataAnnotation)
}
],
"nextPageToken": string
} |
| Поля |
|---|
reportingDataAnnotations[] | object ( ReportingDataAnnotation ) Список аннотаций к отчетным данным. |
nextPageToken | string Токен, который можно отправить как pageToken для получения следующей страницы. Если это поле опущено, последующие страницы отсутствуют. |
Области авторизации
Требуется одна из следующих областей OAuth:
-
https://www.googleapis.com/auth/analytics.readonly -
https://www.googleapis.com/auth/analytics.edit
,
Перечислите все аннотации к данным отчетов для свойства.
HTTP-запрос
GET https://analyticsadmin.googleapis.com/v1alpha/{parent=properties/*}/reportingDataAnnotations
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
| Параметры |
|---|
parent | string Необходимый. Имя ресурса свойства. Формат: свойства/property_id Пример: свойства/123 |
Параметры запроса
| Параметры |
|---|
filter | string Необязательный. Фильтр, ограничивающий список аннотаций к данным отчетов в родительском свойстве. Поддерживаемые поля: - 'имя'
-
title -
description -
annotationDate -
annotationDateRange -
color
Кроме того, этот API предоставляет следующие вспомогательные функции: - annotation_duration(): продолжительность, которую отмечает эта аннотация, длительность . ожидайте числовое представление секунд, за которым следует суффикс
s . - is_annotation_in_range(startDate, endDate) : если аннотация находится в диапазоне, указанном
startDate и endDate . Даты имеют формат ISO-8601, например 2031-06-28
Поддерживаемые операции: -
= : равно -
!= : не равно -
< : меньше чем -
> : больше, чем -
<= : меньше или равно -
>= : больше или равно -
: : имеет оператор -
=~ : совпадение с регулярным выражением -
!~ : регулярное выражение не соответствует -
NOT : Логичное «нет». -
AND : Логично и -
OR : Логическое или
Примеры: -
title="Holiday Sale" -
description=~"[Bb]ig [Gg]ame.*[Ss]ale" -
is_annotation_in_range("2025-12-25", "2026-01-16") = true -
annotation_duration() >= 172800s AND title:BOGO
|
pageSize | integer Необязательный. Максимальное количество возвращаемых ресурсов. Служба может вернуть меньшее значение, чем это, даже если есть дополнительные страницы. Если не указано, будет возвращено не более 50 ресурсов. Максимальное значение — 200; (более высокие значения будут приведены к максимуму) |
pageToken | string Необязательный. Токен страницы, полученный в результате предыдущего вызова reportingDataAnnotations.list . Предоставьте это, чтобы получить следующую страницу. При разбиении на страницы все остальные параметры, предоставленные в reportingDataAnnotations.list , должны соответствовать вызову, который предоставил токен страницы. |
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
Ответное сообщение для RPC ListReportingDataAnnotation.
В случае успеха тело ответа содержит данные следующей структуры:
| JSON-представление |
|---|
{
"reportingDataAnnotations": [
{
object (ReportingDataAnnotation)
}
],
"nextPageToken": string
} |
| Поля |
|---|
reportingDataAnnotations[] | object ( ReportingDataAnnotation ) Список аннотаций к отчетным данным. |
nextPageToken | string Токен, который можно отправить как pageToken для получения следующей страницы. Если это поле опущено, последующие страницы отсутствуют. |
Области авторизации
Требуется одна из следующих областей OAuth:
-
https://www.googleapis.com/auth/analytics.readonly -
https://www.googleapis.com/auth/analytics.edit
,
Перечислите все аннотации к данным отчетов для свойства.
HTTP-запрос
GET https://analyticsadmin.googleapis.com/v1alpha/{parent=properties/*}/reportingDataAnnotations
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
| Параметры |
|---|
parent | string Необходимый. Имя ресурса свойства. Формат: свойства/property_id Пример: свойства/123 |
Параметры запроса
| Параметры |
|---|
filter | string Необязательный. Фильтр, ограничивающий список аннотаций к данным отчетов в родительском свойстве. Поддерживаемые поля: - 'имя'
-
title -
description -
annotationDate -
annotationDateRange -
color
Кроме того, этот API предоставляет следующие вспомогательные функции: - annotation_duration(): продолжительность, которую отмечает эта аннотация, длительность . ожидайте числовое представление секунд, за которым следует суффикс
s . - is_annotation_in_range(startDate, endDate) : если аннотация находится в диапазоне, указанном
startDate и endDate . Даты имеют формат ISO-8601, например 2031-06-28
Поддерживаемые операции: -
= : равно -
!= : не равно -
< : меньше чем -
> : больше, чем -
<= : меньше или равно -
>= : больше или равно -
: : имеет оператор -
=~ : совпадение с регулярным выражением -
!~ : регулярное выражение не соответствует -
NOT : Логичное «нет». -
AND : Логично и -
OR : Логическое или
Примеры: -
title="Holiday Sale" -
description=~"[Bb]ig [Gg]ame.*[Ss]ale" -
is_annotation_in_range("2025-12-25", "2026-01-16") = true -
annotation_duration() >= 172800s AND title:BOGO
|
pageSize | integer Необязательный. Максимальное количество возвращаемых ресурсов. Служба может вернуть меньшее значение, чем это, даже если есть дополнительные страницы. Если не указано, будет возвращено не более 50 ресурсов. Максимальное значение — 200; (более высокие значения будут приведены к максимуму) |
pageToken | string Необязательный. Токен страницы, полученный в результате предыдущего вызова reportingDataAnnotations.list . Предоставьте это, чтобы получить следующую страницу. При разбиении на страницы все остальные параметры, предоставленные в reportingDataAnnotations.list , должны соответствовать вызову, который предоставил токен страницы. |
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
Ответное сообщение для RPC ListReportingDataAnnotation.
В случае успеха тело ответа содержит данные следующей структуры:
| JSON-представление |
|---|
{
"reportingDataAnnotations": [
{
object (ReportingDataAnnotation)
}
],
"nextPageToken": string
} |
| Поля |
|---|
reportingDataAnnotations[] | object ( ReportingDataAnnotation ) Список аннотаций к отчетным данным. |
nextPageToken | string Токен, который можно отправить как pageToken для получения следующей страницы. Если это поле опущено, последующие страницы отсутствуют. |
Области авторизации
Требуется одна из следующих областей OAuth:
-
https://www.googleapis.com/auth/analytics.readonly -
https://www.googleapis.com/auth/analytics.edit
,
Перечислите все аннотации к данным отчетов для свойства.
HTTP-запрос
GET https://analyticsadmin.googleapis.com/v1alpha/{parent=properties/*}/reportingDataAnnotations
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
| Параметры |
|---|
parent | string Необходимый. Имя ресурса свойства. Формат: свойства/property_id Пример: свойства/123 |
Параметры запроса
| Параметры |
|---|
filter | string Необязательный. Фильтр, ограничивающий список аннотаций к данным отчетов в родительском свойстве. Поддерживаемые поля: - 'имя'
-
title -
description -
annotationDate -
annotationDateRange -
color
Кроме того, этот API предоставляет следующие вспомогательные функции: - annotation_duration(): продолжительность, которую отмечает эта аннотация, длительность . ожидайте числовое представление секунд, за которым следует суффикс
s . - is_annotation_in_range(startDate, endDate) : если аннотация находится в диапазоне, указанном
startDate и endDate . Даты имеют формат ISO-8601, например 2031-06-28
Поддерживаемые операции: -
= : равно -
!= : не равно -
< : меньше чем -
> : больше, чем -
<= : меньше или равно -
>= : больше или равно -
: : имеет оператор -
=~ : совпадение с регулярным выражением -
!~ : регулярное выражение не соответствует -
NOT : Логичное «нет». -
AND : Логично и -
OR : Логическое или
Примеры: -
title="Holiday Sale" -
description=~"[Bb]ig [Gg]ame.*[Ss]ale" -
is_annotation_in_range("2025-12-25", "2026-01-16") = true -
annotation_duration() >= 172800s AND title:BOGO
|
pageSize | integer Необязательный. Максимальное количество возвращаемых ресурсов. Служба может вернуть меньшее значение, чем это, даже если есть дополнительные страницы. Если не указано, будет возвращено не более 50 ресурсов. Максимальное значение — 200; (более высокие значения будут приведены к максимуму) |
pageToken | string Необязательный. Токен страницы, полученный в результате предыдущего вызова reportingDataAnnotations.list . Предоставьте это, чтобы получить следующую страницу. При разбиении на страницы все остальные параметры, предоставленные в reportingDataAnnotations.list , должны соответствовать вызову, который предоставил токен страницы. |
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
Ответное сообщение для RPC ListReportingDataAnnotation.
В случае успеха тело ответа содержит данные следующей структуры:
| JSON-представление |
|---|
{
"reportingDataAnnotations": [
{
object (ReportingDataAnnotation)
}
],
"nextPageToken": string
} |
| Поля |
|---|
reportingDataAnnotations[] | object ( ReportingDataAnnotation ) Список аннотаций к отчетным данным. |
nextPageToken | string Токен, который можно отправить как pageToken для получения следующей страницы. Если это поле опущено, последующие страницы отсутствуют. |
Области авторизации
Требуется одна из следующих областей OAuth:
-
https://www.googleapis.com/auth/analytics.readonly -
https://www.googleapis.com/auth/analytics.edit
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-24 UTC.
[null,null,["Последнее обновление: 2025-07-24 UTC."],[],[],null,["# Method: properties.reportingDataAnnotations.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListReportingDataAnnotationsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nList all Reporting Data Annotations on a property.\n\n### HTTP request\n\n`GET https://analyticsadmin.googleapis.com/v1alpha/{parent=properties/*}/reportingDataAnnotations`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|----------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. Resource name of the property. Format: properties/property_id Example: properties/123 |\n\n### Query parameters\n\n| Parameters ||\n|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `filter` | `string` Optional. Filter that restricts which reporting data annotations under the parent property are listed. Supported fields are: - 'name' - `title` - `description` - `annotationDate` - `annotationDateRange` - `color` Additionally, this API provides the following helper functions: - annotation_duration() : the duration that this annotation marks, [durations](https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/duration.proto). expect a numeric representation of seconds followed by an `s` suffix. - is_annotation_in_range(startDate, endDate) : if the annotation is in the range specified by the `startDate` and `endDate`. The dates are in ISO-8601 format, for example `2031-06-28`. Supported operations: - `=` : equals - `!=` : not equals - `\u003c` : less than - `\u003e` : greater than - `\u003c=` : less than or equals - `\u003e=` : greater than or equals - `:` : has operator - `=~` : [regular expression](https://github.com/google/re2/wiki/Syntax) match - `!~` : [regular expression](https://github.com/google/re2/wiki/Syntax) does not match - `NOT` : Logical not - `AND` : Logical and - `OR` : Logical or Examples: 1. `title=\"Holiday Sale\"` 2. `description=~\"[Bb]ig [Gg]ame.*[Ss]ale\"` 3. `is_annotation_in_range(\"2025-12-25\", \"2026-01-16\") = true` 4. `annotation_duration() \u003e= 172800s AND title:BOGO` |\n| `pageSize` | `integer` Optional. The maximum number of resources to return. The service may return fewer than this value, even if there are additional pages. If unspecified, at most 50 resources will be returned. The maximum value is 200; (higher values will be coerced to the maximum) |\n| `pageToken` | `string` Optional. A page token, received from a previous `reportingDataAnnotations.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `reportingDataAnnotations.list` must match the call that provided the page token. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for ListReportingDataAnnotation RPC.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"reportingDataAnnotations\": [ { object (/analytics/devguides/config/admin/v1/rest/v1alpha/properties.reportingDataAnnotations#ReportingDataAnnotation) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `reportingDataAnnotations[]` | `object (`[ReportingDataAnnotation](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.reportingDataAnnotations#ReportingDataAnnotation)`)` List of Reporting Data Annotations. |\n| `nextPageToken` | `string` A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/analytics.readonly`\n- `https://www.googleapis.com/auth/analytics.edit`"]]
