Prueba el servidor de MCP para Google Analytics. Instala desde
GitHub y consulta el
anuncio para obtener más detalles.
Method: properties.audienceLists.create
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Crea una lista de público para su recuperación posterior. Este método muestra rápidamente el nombre del recurso de la lista de público y, luego, inicia una solicitud asíncrona de larga duración para formar una lista de público. Para incluir a los usuarios en una lista de público, primero crea la lista de público con este método y, luego, envía el nombre del recurso de público al método audienceLists.query.
Consulta Cómo crear una lista de público para obtener una introducción a las listas de público con ejemplos.
Una lista de público es un resumen de los usuarios que se encuentran actualmente en el público en el momento de la creación de la lista de público. Si crea listas de público para un público en días diferentes, obtendrá 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 listas de público contienen los usuarios de cada público.
Este método está disponible con estabilidad beta en audienceExports.create. 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/v1alpha/{parent=properties/*}/audienceLists
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 lista de público. Formato: properties/{property}
|
Cuerpo de la solicitud
El cuerpo de la solicitud incluye una instancia de AudienceList.
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.readonlyhttps://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 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`"]]
