MCP-Server für Google Analytics ausprobieren Installieren Sie das Tool über
GitHub. Weitere Informationen finden Sie in der
Ankündigung.
Method: properties.audienceExports.create
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Es wird ein Zielgruppenexport erstellt, der später abgerufen werden kann. Diese Methode gibt schnell den Ressourcennamen des Zielgruppenexports zurück und initiiert eine lange laufende asynchrone Anfrage zum Erstellen eines Zielgruppenexports. Wenn Sie die Nutzer eines Zielgruppenexports exportieren möchten, erstellen Sie zuerst den Zielgruppenexport mit dieser Methode und senden Sie dann den Namen der Zielgruppenressource an die Methode audienceExports.query.
Unter Zielgruppenexport erstellen finden Sie eine Einführung in Zielgruppenexporte mit Beispielen.
Beim Zielgruppenexport handelt es sich um eine Übersicht der Nutzer, die zum Zeitpunkt des Erstellens des Zielgruppenexports derzeit in der Zielgruppe sind. Wenn Sie Zielgruppenexporte 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. Zielgruppenexporte enthalten die Nutzer für jede Zielgruppe.
Bei den Audience Export APIs gibt es einige Methoden in der Alphaphase, andere in der Betaversion. Nach Feedback und Einführung ist geplant, die Methoden zur Beta-Stabilität weiter auszubauen. 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/v1beta/{parent=properties/*}/audienceExports
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
parent |
string
Erforderlich. Die übergeordnete Ressource, in der dieser Zielgruppenexport erstellt wird. Format: properties/{property}
|
Anfragetext
Der Anfragetext enthält eine Instanz von AudienceExport.
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 export for later retrieval that contains a snapshot of users in an audience at the time of creation.\u003c/p\u003e\n"],["\u003cp\u003eThe API initiates a long-running asynchronous request to form an audience export, and the audience export's resource name is returned quickly.\u003c/p\u003e\n"],["\u003cp\u003eTo export users in an audience export, first create the audience export and then use the \u003ccode\u003eaudienceExports.query\u003c/code\u003e method with the audience resource name.\u003c/p\u003e\n"],["\u003cp\u003eAudience exports may vary day-to-day as users join or leave the audience being exported.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with either the \u003ccode\u003eanalytics.readonly\u003c/code\u003e or \u003ccode\u003eanalytics\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This outlines the process of creating an audience export through an API. It involves sending a POST request to a specified URL, including the parent property ID in the path parameters. The request body uses an `AudienceExport` instance. Upon success, it returns an `Operation` instance, signifying a long-running process. The audience export captures a user snapshot at creation, and different creations yield varied user lists. The API requires specific OAuth scopes for authorization.\n"],null,["# Method: properties.audienceExports.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 export for later retrieval. This method quickly returns the audience export's resource name and initiates a long running asynchronous request to form an audience export. To export the users in an audience export, first create the audience export through this method and then send the audience resource name to the `audienceExports.query` method.\n\nSee [Creating an Audience Export](https://developers.google.com/analytics/devguides/reporting/data/v1/audience-list-basics) for an introduction to Audience Exports with examples.\n\nAn audience export is a snapshot of the users currently in the audience at the time of audience export creation. Creating audience exports 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 exports contain the users in each audience.\n\nAudience Export APIs have some methods at alpha and other methods at beta stability. The intention is to advance methods to beta stability after some feedback and adoption. 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/v1beta/{parent=properties/*}/audienceExports`\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 export will be created. Format: `properties/{property}` |\n\n### Request body\n\nThe request body contains an instance of [AudienceExport](/analytics/devguides/reporting/data/v1/rest/v1beta/properties.audienceExports#AudienceExport).\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`"]]
