Method: properties.audienceLists.create

Cria uma lista de público-alvo para recuperação posterior. Esse método retorna rapidamente o nome do recurso da lista de público-alvo e inicia uma solicitação assíncrona de longa duração para formar uma lista de público-alvo. Para listar os usuários em uma lista de público-alvo, primeiro crie a lista usando esse método e, em seguida, envie o nome do recurso de público-alvo para o método audienceLists.query.

Consulte Criar uma lista de público-alvo para uma introdução a listas de público-alvo com exemplos.

Uma lista de público-alvo é um resumo dos usuários que estavam nele no momento da criação da lista. Criar listas de público-alvo para um público-alvo em dias diferentes vai retornar resultados diferentes à medida que os usuários entram e saem do público-alvo.

Com os públicos-alvo no Google Analytics 4, é possível segmentar os usuários mais relevantes para sua empresa. Para saber mais, consulte https://support.google.com/analytics/answer/9267572. As listas de público-alvo contêm os usuários de cada público-alvo.

Esse método está disponível na versão Beta de estabilidade em audienceExports.create. Para enviar seu feedback sobre a API, preencha o formulário Feedback sobre a API Audience Export do Google Analytics.

Solicitação HTTP

POST https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/audienceLists

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

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O recurso pai em que essa lista de público-alvo será criada. Formato: properties/{property}

Corpo da solicitação

O corpo da solicitação contém uma instância de AudienceList.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de Operation.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

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