Method: properties.audienceLists.list

Muestra todas las listas de público de una propiedad. Puedes usar este método para encontrar y volver a usar listas de público existentes en lugar de crear listas de público nuevas innecesarias. El mismo público puede tener varias listas de público que representen la lista de usuarios que estuvieron en un público en diferentes días.

Consulta Cómo crear una lista de público para obtener una introducción a las listas de público con ejemplos.

Este método está disponible en la estabilidad de la versión beta en audienceExports.list. Para enviar tus comentarios sobre esta API, completa el formulario Comentarios sobre la API de Google Analytics Audience Export.

Solicitud HTTP

GET 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. Todas las listas de público de esta propiedad aparecerán en la respuesta. Formato: properties/{property}

Parámetros de consulta

Parámetros
pageSize

integer

Opcional. Es la cantidad máxima de listas de público que se mostrarán. El servicio puede mostrar menos que este valor. Si no se especifica, se mostrarán como máximo 200 listas de público. El valor máximo es 1,000 (los valores más altos se convertirán al máximo).
pageToken

string

Opcional. Un token de página, recibido desde una llamada audienceLists.list anterior. Proporciona esto para recuperar la página siguiente.

Cuando se pagina, todos los demás parámetros proporcionados a audienceLists.list deben coincidir con la llamada que proporcionó el token de la página.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es una lista de todas las listas de público de una propiedad.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "audienceLists": [
    {
      object (AudienceList)
    }
  ],
  "nextPageToken": string
}
Campos
audienceLists[]

object (AudienceList)

Cada lista de público de una propiedad
nextPageToken

string

Un token, que se puede enviar como pageToken para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics