Method: properties.recurringAudienceLists.list

Muestra una lista de todas las listas de público recurrentes de una propiedad. Puede utilizar este método para buscar y reutilizar listas de público recurrentes existentes, en lugar de crear nuevas listas de público recurrentes innecesarias. El mismo público puede tener varias listas de público recurrentes que representan diferentes combinaciones de dimensiones, por ejemplo, solo la dimensión deviceId o ambas dimensiones deviceId y userId.

Este método se introduce durante el período de estabilidad de la versión alfa con la intención de reunir comentarios sobre la sintaxis y las funciones antes de proceder a la versión beta. 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/*}/recurringAudienceLists

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. En la respuesta, se enumerarán todas las listas de público recurrentes de esta propiedad. Formato: properties/{property}

Parámetros de consulta

Parámetros
pageSize

integer

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

pageToken

string

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

Cuando se pagina, todos los demás parámetros proporcionados a recurringAudienceLists.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 recurrentes de una propiedad.

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

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

object (RecurringAudienceList)

Cada lista de público recurrente 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 alcances de OAuth:

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