Method: properties.audienceLists.create

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.readonly
  • https://www.googleapis.com/auth/analytics