MCP-Server für Google Analytics ausprobieren Installieren Sie das Tool über
GitHub. Weitere Informationen finden Sie in der
Ankündigung.
Method: properties.audienceLists.list
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Listet alle Zielgruppenlisten für eine Property auf. So können Sie vorhandene Zielgruppenlisten finden und wiederverwenden, anstatt unnötig neue Zielgruppenlisten zu erstellen. Für dieselbe Zielgruppe können mehrere Zielgruppenlisten vorhanden sein, die die Nutzerlisten darstellen, die an verschiedenen Tagen zu einer Zielgruppe gehörten.
Im Hilfeartikel Zielgruppenliste erstellen finden Sie eine Einführung in Zielgruppenlisten mit Beispielen.
Diese Methode ist in der Betaversion unter audienceExports.list verfügbar. Wenn Sie Feedback zu dieser API geben möchten, füllen Sie bitte das Feedback-Formular zur Google Analytics Audience Export API aus.
HTTP-Anfrage
GET https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/audienceLists
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
parent |
string
Erforderlich. In der Antwort werden alle Zielgruppenlisten für diese Property aufgeführt. Format: properties/{property}
|
Suchparameter
| Parameter |
pageSize |
integer
Optional. Die maximale Anzahl der Zielgruppenlisten, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 200 Zielgruppenlisten zurückgegeben. Der Höchstwert ist 1.000. Höhere Werte werden auf den Höchstwert festgelegt.
|
pageToken |
string
Optional. Ein Seitentoken, das von einem vorherigen audienceLists.list-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen. Beim Paginieren müssen alle anderen für audienceLists.list bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Eine Liste aller Zielgruppenlisten für eine Property.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"audienceLists": [
{
object (AudienceList)
}
],
"nextPageToken": string
} |
| Felder |
audienceLists[] |
object (AudienceList)
Jede Zielgruppenliste für eine Property.
|
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
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 audience lists for a given Google Analytics property, allowing for reuse of existing lists.\u003c/p\u003e\n"],["\u003cp\u003eProvides pagination to handle large numbers of audience lists, with customizable page size.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific authorization scopes for access, either read-only or full Analytics access.\u003c/p\u003e\n"],["\u003cp\u003eUses a standard HTTP GET request with path and query parameters to specify the property and retrieval options.\u003c/p\u003e\n"],["\u003cp\u003eReturns a JSON response containing an array of audience lists and a token for retrieving subsequent pages.\u003c/p\u003e\n"]]],["This document outlines how to retrieve a list of audience lists for a specific property using the Google Analytics Data API. It utilizes a `GET` HTTP request to the `audienceLists` endpoint, specifying the property in the `parent` path parameter. Optional query parameters include `pageSize` to limit results and `pageToken` for pagination. The request body must be empty. Successful responses include an array of `audienceLists` and a `nextPageToken` for subsequent pages. This operation requires `analytics.readonly` or `analytics` authorization scopes.\n"],null,["# Method: properties.audienceLists.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.ListAudienceListsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists all audience lists for a property. This method can be used for you to find and reuse existing audience lists rather than creating unnecessary new audience lists. The same audience can have multiple audience lists that represent the list of users that were in an audience on different days.\n\nSee [Creating an Audience List](https://developers.google.com/analytics/devguides/reporting/data/v1/audience-list-basics) for an introduction to Audience Lists with examples.\n\nThis method is available at beta stability at [audienceExports.list](https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/properties.audienceExports/list). To give your feedback on this API, complete the [Google Analytics Audience Export API Feedback](https://forms.gle/EeA5u5LW6PEggtCEA) form.\n\n### HTTP request\n\n`GET https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/audienceLists`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. All audience lists for this property will be listed in the response. Format: `properties/{property}` |\n\n### Query parameters\n\n| Parameters ||\n|---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `page``Size` | `integer` Optional. The maximum number of audience lists to return. The service may return fewer than this value. If unspecified, at most 200 audience lists will be returned. The maximum value is 1000 (higher values will be coerced to the maximum). |\n| `page``Token` | `string` Optional. A page token, received from a previous `audienceLists.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `audienceLists.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\nA list of all audience lists for a property.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"audienceLists\": [ { object (/analytics/devguides/reporting/data/v1/rest/v1alpha/properties.audienceLists#AudienceList) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|---------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `audience``Lists[]` | `object (`[AudienceList](/analytics/devguides/reporting/data/v1/rest/v1alpha/properties.audienceLists#AudienceList)`)` Each audience list for a property. |\n| `next``Page``Token` | `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`"]]
