MCP-Server für Google Analytics ausprobieren Installieren Sie das Tool über
GitHub. Weitere Informationen finden Sie in der
Ankündigung.
Method: properties.customDimensions.list
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Listet CustomDimensions für eine Eigenschaft auf.
HTTP-Anfrage
GET https://analyticsadmin.googleapis.com/v1beta/{parent=properties/*}/customDimensions
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
parent |
string
Erforderlich. Beispielformat: properties/1234
|
Abfrageparameter
| Parameter |
pageSize |
integer
Die maximale Anzahl der Ressourcen, die zurückgegeben werden sollen. Wenn nicht angegeben, werden maximal 50 Ressourcen zurückgegeben. Der Höchstwert ist 200 (höhere Werte werden zum Höchstwert gezwungen).
|
pageToken |
string
Ein Seitentoken, das von einem vorherigen customDimensions.list-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen. Beim Paginieren müssen alle anderen für customDimensions.list bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwortnachricht für customDimensions.list-RPC.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"customDimensions": [
{
object (CustomDimension)
}
],
"nextPageToken": string
} |
| Felder |
customDimensions[] |
object (CustomDimension)
Liste der benutzerdefinierten Dimensionen.
|
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 CustomDimensions configured for a specified Google Analytics 4 property.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination to retrieve large lists of CustomDimensions.\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 details on the HTTP request structure, including path and query parameters.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes a list of CustomDimensions and a token for retrieving subsequent pages if available.\u003c/p\u003e\n"]]],["This document details how to list CustomDimensions within a property using the Google Analytics Admin API. The core action is performing a `GET` request to the specified URL, which includes a required `parent` path parameter (e.g., properties/1234). Optional query parameters `pageSize` and `pageToken` enable pagination. The request body is empty. A successful response returns a JSON structure containing a list of `customDimensions` and a `nextPageToken` for further pages. Authorization requires specific OAuth scopes.\n"],null,["# Method: properties.customDimensions.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.ListCustomDimensionsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists CustomDimensions on a property.\n\n### HTTP request\n\n`GET https://analyticsadmin.googleapis.com/v1beta/{parent=properties/*}/customDimensions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|----------------------------------------------------|\n| `parent` | `string` Required. Example format: properties/1234 |\n\n### Query parameters\n\n| Parameters ||\n|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of resources to return. 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 `customDimensions.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `customDimensions.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 customDimensions.list RPC.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"customDimensions\": [ { object (/analytics/devguides/config/admin/v1/rest/v1beta/properties.customDimensions#CustomDimension) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customDimensions[]` | `object (`[CustomDimension](/analytics/devguides/config/admin/v1/rest/v1beta/properties.customDimensions#CustomDimension)`)` List of CustomDimensions. |\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`"]]
