Method: customers.userListQueries.start

Inicia a execução em uma consulta de lista de usuários armazenada. Os resultados são enviados para a lista de usuários especificada do Google Ads. O nome da operação retornada pode ser usado para pesquisar o status de conclusão da consulta.

Solicitação HTTP

POST https://adsdatahub.googleapis.com/v1/{name=customers/*/userListQueries/*}:start

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

Parâmetros de caminho

Parâmetros
name

string

Nome completo do recurso, por exemplo, 'customers/123/userListqueries/abcd1234'.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "spec": {
    object (QueryExecutionSpec)
  },
  "userListId": string,
  "customerId": string
}
Campos
spec

object (QueryExecutionSpec)

Define os parâmetros de execução da consulta.

userListId

string (int64 format)

ID da lista de usuários do Google Ads. A lista de usuários precisa ser gerenciada pelo cliente do Ads Data Hub que executa a consulta.

customerId

string (int64 format)

Opcional. Cliente do Ads Data Hub que executa a consulta. Caso o valor não seja especificado, o padrão será o cliente proprietário da consulta.

Corpo da resposta

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

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/adsdatahub