Method: customers.searchAudienceInsightsAttributes

Pesquisa atributos de público-alvo que podem ser usados para gerar insights.

Lista de erros gerados: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

Solicitação HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}:searchAudienceInsightsAttributes

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

Parâmetros de caminho

Parâmetros
customerId

string

Obrigatório. O ID do cliente.

Corpo da solicitação

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

Representação JSON 
{
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "queryText": string,
  "customerInsightsGroup": string,
  "locationCountryFilters": [
    {
      object (LocationInfo)
    }
  ]
}
Campos
dimensions[]

enum (AudienceInsightsDimension)

Obrigatório. Os tipos de atributos a serem retornados.
queryText

string

Obrigatório. Uma consulta de texto livre. Se as dimensões solicitadas incluírem Atributos CATEGORY ou KNOWLEDGE_GRAPH, os atributos retornados para essas dimensões corresponderão ou estarão relacionados a essa string. Para outras dimensões, este campo é ignorado e todos os atributos disponíveis são retornados.
customerInsightsGroup

string

O nome do cliente para quem está sendo planejado. Esse é um valor definido pelo usuário.
locationCountryFilters[]

object (LocationInfo)

Se os atributos SUB_COUNTRY_LOCATION forem uma das dimensões solicitadas e esse campo estiver presente, os atributos SUB_COUNTRY_LOCATION retornados ficarão localizados nesses países. Se esse campo estiver ausente, os atributos de local não serão filtrados por país. Definir este campo quando os atributos SUB_COUNTRY_LOCATION não forem solicitados retornará um erro.

Corpo da resposta

Mensagem de resposta para AudienceInsightsService.ListAudienceInsightsAttributes.

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

Representação JSON 
{
  "attributes": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ]
}
Campos
attributes[]

object (AudienceInsightsAttributeMetadata)

Os atributos que correspondem à consulta de pesquisa.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.