MCP-Server für Google Analytics ausprobieren Installieren Sie das Tool über
GitHub. Weitere Informationen finden Sie in der
Ankündigung.
Method: properties.list
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Hiermit werden untergeordnete Properties des angegebenen übergeordneten Kontos zurückgegeben.
Properties werden ausgeschlossen, wenn der Aufrufer keinen Zugriff hat. Vorläufig gelöschte Properties (d. h. im Papierkorb befindliche Properties) werden standardmäßig ausgeschlossen. Wenn keine relevanten Properties gefunden werden, wird eine leere Liste zurückgegeben.
HTTP-Anfrage
GET https://analyticsadmin.googleapis.com/v1alpha/properties
Die URL verwendet die Syntax der gRPC-Transcodierung.
Abfrageparameter
| Parameter |
filter |
string
Erforderlich. Ein Ausdruck zum Filtern der Anfrageergebnisse. Folgende Felder können gefiltert werden: parent:(Ressourcenname des übergeordneten Kontos/der übergeordneten Property), ancestor:(Ressourcenname des übergeordneten Kontos) oder firebase_project:(ID oder Nummer des verknüpften Firebase-Projekts). Beispiele für Filter:
| 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
Die maximale Anzahl der zurückzugebenden Ressourcen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück, auch wenn es weitere Seiten gibt. Wenn nicht angegeben, werden maximal 50 Ressourcen zurückgegeben. Der Höchstwert ist 200. Höhere Werte werden auf den Höchstwert festgelegt.
|
pageToken |
string
Ein Seitentoken, das von einem vorherigen properties.list-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen. Beim Paginieren müssen alle anderen für properties.list bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.
|
showDeleted |
boolean
Gibt an, ob vormals gelöschte Properties (d. h. im Papierkorb befindliche Properties) in die Ergebnisse eingeschlossen werden sollen. Sie können prüfen, ob Properties gelöscht wurden.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwortnachricht für den RPC-Vorgang „properties.list“
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"properties": [
{
object (Property)
}
],
"nextPageToken": string
} |
| Felder |
properties[] |
object (Property)
Ergebnisse, die den Filterkriterien entsprechen und für den Anrufer zugänglich sind.
|
nextPageToken |
string
Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.
|
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/analytics.readonlyhttps://www.googleapis.com/auth/analytics.edit
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-26 (UTC)."],[[["\u003cp\u003eLists all Google Analytics 4 properties under a specified parent account, excluding soft-deleted properties by default.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by parent account, ancestor account, 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 for retrieving large result sets.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with either \u003ccode\u003eanalytics.readonly\u003c/code\u003e or \u003ccode\u003eanalytics.edit\u003c/code\u003e scopes.\u003c/p\u003e\n"],["\u003cp\u003eReturns an empty list if no matching properties are found or if the user lacks access.\u003c/p\u003e\n"]]],["This describes how to list child properties under a parent account using a `GET` request to `https://analyticsadmin.googleapis.com/v1alpha/properties`. The request requires a filter parameter to specify the parent. Additional optional query parameters include `pageSize`, `pageToken`, and `showDeleted`. The request body must be empty. A successful response includes a list of `properties` and a `nextPageToken` for pagination. Authorization requires `analytics.readonly` or `analytics.edit` scopes.\n"],null,["# Method: properties.list\n\n- [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\n### HTTP request\n\n`GET https://analyticsadmin.googleapis.com/v1alpha/properties`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query 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\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse 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/v1alpha/properties#Property) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `properties[]` | `object (`[Property](/analytics/devguides/config/admin/v1/rest/v1alpha/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\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`"]]
