MCP-Server für Google Analytics ausprobieren Installieren Sie das Tool über
GitHub. Weitere Informationen finden Sie in der
Ankündigung.
Method: properties.audienceLists.create
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Erstellt eine Zielgruppenliste zum späteren Abrufen Diese Methode gibt schnell den Ressourcennamen der Zielgruppenliste zurück und initiiert eine lange laufende asynchrone Anfrage zum Erstellen einer Zielgruppenliste. Wenn Sie die Nutzer in einer Zielgruppenliste auflisten möchten, erstellen Sie die Zielgruppenliste zuerst mit dieser Methode und senden Sie dann den Namen der Zielgruppenressource an die Methode audienceLists.query.
Eine Einführung in Zielgruppenlisten mit Beispielen finden Sie unter Zielgruppenlisten erstellen.
Eine Zielgruppenliste ist eine Übersicht der Nutzer, die zum Zeitpunkt der Erstellung der Zielgruppenliste in der jeweiligen Zielgruppe enthalten sind. Wenn Sie Zielgruppenlisten für eine Zielgruppe an verschiedenen Tagen erstellen, erhalten Sie unterschiedliche Ergebnisse, wenn Nutzer die Zielgruppe betreten oder verlassen.
Mit Zielgruppen in Google Analytics 4 können Sie Ihre Nutzer so segmentieren, wie es für Sie sinnvoll ist. Weitere Informationen finden Sie unter https://support.google.com/analytics/answer/9267572. Zielgruppenlisten enthalten die Nutzer für die einzelnen Zielgruppen.
Diese Methode ist in der Betaversion unter audienceExports.create verfügbar. Wenn Sie uns Feedback zu dieser API geben möchten, füllen Sie bitte das Feedback-Formular zur Google Analytics Audience Export API aus.
HTTP-Anfrage
POST https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/audienceLists
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
parent |
string
Erforderlich. Die übergeordnete Ressource, in der die Zielgruppenliste erstellt wird. Format: properties/{property}
|
Anfragetext
Der Anfragetext enthält eine Instanz von AudienceList.
Antworttext
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Operation.
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\u003eCreates an audience list containing a snapshot of users in an audience at the time of creation, allowing for later retrieval and querying.\u003c/p\u003e\n"],["\u003cp\u003eThe method utilizes an asynchronous request, returning the audience list resource name immediately while the list formation process occurs in the background.\u003c/p\u003e\n"],["\u003cp\u003eAudience lists are dynamic and reflect the current state of an audience; creating lists on different days for the same audience may yield varied results due to user fluctuations.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes the \u003ccode\u003eaudienceExports.create\u003c/code\u003e method at beta stability, requiring specific authorization scopes for access.\u003c/p\u003e\n"]]],["This API method facilitates the creation of audience lists in Google Analytics 4. It initiates an asynchronous process to generate a list of users matching a defined audience. Key actions include sending a POST request to `audienceLists` with a defined `parent` path parameter, representing the property. The request body defines the audience list, and the successful response includes the audience list's resource name and an Operation instance. Authorization requires specific OAuth scopes. The newly created list can then be used for user segmentation.\n"],null,["# Method: properties.audienceLists.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates an audience list for later retrieval. This method quickly returns the audience list's resource name and initiates a long running asynchronous request to form an audience list. To list the users in an audience list, first create the audience list through this method and then send the audience resource name to the `audienceLists.query` method.\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\nAn audience list is a snapshot of the users currently in the audience at the time of audience list creation. Creating audience lists for one audience on different days will return different results as users enter and exit the audience.\n\nAudiences in Google Analytics 4 allow you to segment your users in the ways that are important to your business. To learn more, see \u003chttps://support.google.com/analytics/answer/9267572\u003e. Audience lists contain the users in each audience.\n\nThis method is available at beta stability at [audienceExports.create](https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/properties.audienceExports/create). 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`POST 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. The parent resource where this audience list will be created. Format: `properties/{property}` |\n\n### Request body\n\nThe request body contains an instance of [AudienceList](/analytics/devguides/reporting/data/v1/rest/v1alpha/properties.audienceLists#AudienceList).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Operation](/analytics/devguides/reporting/data/v1/rest/Shared.Types/Operation).\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`"]]
