Попробуйте сервер MCP для Google Analytics. Установите его с
GitHub и ознакомьтесь с
анонсом для получения более подробной информации.
Method: properties.list
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Возвращает дочерние свойства указанной родительской учетной записи.
Свойства будут исключены, если у вызывающего объекта нет доступа. Обратно удаленные (т. е. «удаленные») свойства исключаются по умолчанию. Возвращает пустой список, если соответствующие свойства не найдены.
HTTP-запрос
GET https://analyticsadmin.googleapis.com/v1beta/properties
URL-адрес использует синтаксис транскодирования gRPC .
Параметры запроса
| Параметры |
|---|
filter | string Необходимый. Выражение для фильтрации результатов запроса. Поля, подходящие для фильтрации: parent: (имя ресурса родительской учетной записи/ресурса) или ancestor: (имя ресурса родительской учетной записи) или firebase_project: (идентификатор или номер связанного проекта Firebase). Несколько примеров фильтров: | Filter | Description |
|-----------------------------|-------------------------------------------|
| parent:accounts/123 | The account with account id: 123. |
| parent:properties/123 | The property with property id: 123. |
| ancestor:accounts/123 | The account with account id: 123. |
| firebase_project:project-id | The firebase project with id: project-id. |
| firebase_project:123 | The firebase project with number: 123. |
|
pageSize | integer Максимальное количество возвращаемых ресурсов. Служба может вернуть меньшее значение, чем это, даже если есть дополнительные страницы. Если не указано, будет возвращено не более 50 ресурсов. Максимальное значение — 200; (более высокие значения будут приведены к максимуму) |
pageToken | string Токен страницы, полученный в результате предыдущего вызова properties.list . Предоставьте это, чтобы получить следующую страницу. При разбиении на страницы все остальные параметры, предоставленные в файле properties.list должны соответствовать вызову, который предоставил токен страницы. |
showDeleted | boolean Включать ли обратимо удаленные (т. е. «удаленные») свойства в результаты. Свойства можно проверить, чтобы определить, удалены они или нет. |
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
Ответное сообщение для RPC Properties.list.
В случае успеха тело ответа содержит данные следующей структуры:
| JSON-представление |
|---|
{
"properties": [
{
object (Property)
}
],
"nextPageToken": string
} |
| Поля |
|---|
properties[] | object ( Property ) Результаты, соответствующие критериям фильтра и доступные вызывающему абоненту. |
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."],[[["\u003cp\u003eReturns a list of "GA4" properties under a specified parent Account, excluding those without user access and soft-deleted ones.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering results by parent, ancestor, or linked Firebase project using the \u003ccode\u003efilter\u003c/code\u003e query parameter.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination with \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e parameters to retrieve large result sets.\u003c/p\u003e\n"],["\u003cp\u003eRequires \u003ccode\u003eanalytics.readonly\u003c/code\u003e or \u003ccode\u003eanalytics.edit\u003c/code\u003e authorization scopes for access.\u003c/p\u003e\n"],["\u003cp\u003eProvides a JSON response containing an array of properties and a token for retrieving subsequent pages.\u003c/p\u003e\n"]]],["This document details how to retrieve a list of child properties under a specified parent account using a `GET` request to the provided URL. Key actions involve using query parameters such as `filter`, `pageSize`, `pageToken`, and `showDeleted` to refine the search. The `filter` parameter allows specification of parent account/property, ancestor, or firebase project. The response body, in JSON format, returns a list of accessible properties and a `nextPageToken` for pagination. The process requires specific authorization scopes.\n"],null,["- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListPropertiesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReturns child Properties under the specified parent Account.\n\nProperties will be excluded if the caller does not have access. Soft-deleted (ie: \"trashed\") properties are excluded by default. Returns an empty list if no relevant properties are found.\n\nHTTP request\n\n`GET https://analyticsadmin.googleapis.com/v1beta/properties`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\nQuery parameters\n\n| Parameters ||\n|---------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `filter` | `string` Required. An expression for filtering the results of the request. Fields eligible for filtering are: `parent:`(The resource name of the parent account/property) or `ancestor:`(The resource name of the parent account) or `firebase_project:`(The id or number of the linked firebase project). Some examples of filters: | Filter | Description | |-----------------------------|-------------------------------------------| | parent:accounts/123 | The account with account id: 123. | | parent:properties/123 | The property with property id: 123. | | ancestor:accounts/123 | The account with account id: 123. | | firebase_project:project-id | The firebase project with id: project-id. | | firebase_project:123 | The firebase project with number: 123. | |\n| `pageSize` | `integer` 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` A page token, received from a previous `properties.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `properties.list` must match the call that provided the page token. |\n| `showDeleted` | `boolean` Whether to include soft-deleted (ie: \"trashed\") Properties in the results. Properties can be inspected to determine whether they are deleted or not. |\n\nRequest body\n\nThe request body must be empty.\n\nResponse body Response message for properties.list RPC.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"properties\": [ { object (/analytics/devguides/config/admin/v1/rest/v1beta/properties#Property) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `properties[]` | `object (`[Property](/analytics/devguides/config/admin/v1/rest/v1beta/properties#Property)`)` Results that matched the filter criteria and were accessible to the caller. |\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\nAuthorization 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`"]]
