Method: properties.recurringAudienceLists.list

Lista todas as listas de público-alvo recorrentes de uma propriedade. Esse método pode ser usado para encontrar e reutilizar listas de público-alvo recorrentes existentes, em vez de criar novas listas de público-alvo recorrentes desnecessárias. O mesmo público-alvo pode ter várias listas recorrentes que representam combinações de dimensões diferentes. Por exemplo, somente a dimensão deviceId ou ambas as dimensões deviceId e userId.

Esse método é introduzido na estabilidade Alfa com a intenção de coletar feedback sobre a sintaxe e os recursos antes de chegar à versão Beta. Para enviar feedback sobre essa API, preencha o formulário Feedback sobre a API Audience Export do Google Analytics.

Solicitação HTTP

GET https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/recurringAudienceLists

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. Todas as listas de público-alvo recorrentes dessa propriedade serão incluídas na resposta. Formato: properties/{property}

Parâmetros de consulta

Parâmetros
pageSize

integer

Opcional. O número máximo de listas de público-alvo recorrentes a serem retornadas. O serviço pode retornar menos que esse valor. Se não for especificado, serão retornadas no máximo 200 listas de público-alvo recorrentes. O valor máximo é 1.000 (valores mais altos serão convertidos para o máximo).

pageToken

string

Opcional. Um token de página recebido de uma chamada recurringAudienceLists.list anterior. Forneça isso para recuperar a página subsequente.

Ao paginar, todos os outros parâmetros fornecidos para recurringAudienceLists.list precisam corresponder à chamada que forneceu o token da página.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Uma lista de todas as listas de público-alvo recorrentes de uma propriedade.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "recurringAudienceLists": [
    {
      object (RecurringAudienceList)
    }
  ],
  "nextPageToken": string
}
Campos
recurringAudienceLists[]

object (RecurringAudienceList)

Cada lista de público-alvo recorrente de uma propriedade.

nextPageToken

string

Um token, que pode ser enviado como pageToken para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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