Prueba el servidor de MCP para Google Analytics. Instala desde
GitHub y consulta el
anuncio para obtener más detalles.
Method: properties.audienceExports.create
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Crea una exportación de público para su posterior recuperación. Este método muestra rápidamente el nombre del recurso de la exportación del público y, luego, inicia una solicitud asíncrona de larga duración para formar una exportación de público. Para exportar los usuarios en una exportación de público, primero crea la exportación de público con este método y, luego, envía el nombre del recurso de público al método audienceExports.query
.
Consulta Cómo crear una exportación de público para obtener una introducción a las exportaciones de públicos con ejemplos.
Una exportación de público es un resumen de los usuarios que se encuentran actualmente en el público en el momento en que se creó la exportación de público. Si creas exportaciones de públicos para un público en días diferentes, obtendrás resultados diferentes a medida que los usuarios ingresen al público o salgan de él.
Los públicos de Google Analytics 4 te permiten segmentar a tus usuarios de formas significativas para tu empresa. Para obtener más información, consulta https://support.google.com/analytics/answer/9267572. Las exportaciones de públicos contienen los usuarios de cada público.
Las APIs de exportación de públicos tienen algunos métodos en versión alfa y otros en estabilidad. El objetivo es que los métodos avancen hacia la estabilidad beta después de algunos comentarios y su adopción. Para enviar tus comentarios sobre esta API, completa el formulario Comentarios sobre la API de Google Analytics Audience Export.
Solicitud HTTP
POST https://analyticsdata.googleapis.com/v1beta/{parent=properties/*}/audienceExports
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros |
parent |
string
Obligatorio. El recurso superior en el que se creará esta exportación de público. Formato: properties/{property}
|
Cuerpo de la solicitud
El cuerpo de la solicitud incluye una instancia de AudienceExport
.
Cuerpo de la respuesta
Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Operation
.
Permisos de autorización
Se necesita uno de los siguientes alcances de OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-26 (UTC)
[null,null,["Última actualización: 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`"]]