- Solicitação HTTP
- Parâmetros de caminho
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- Faça um teste
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/v16/customers/{customerId}:searchAudienceInsightsAttributes
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros | |
---|---|
customerId |
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 ( |
Campos | |
---|---|
dimensions[] |
Obrigatório. Os tipos de atributos a serem retornados. |
queryText |
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, esse campo é ignorado e todos os atributos disponíveis são retornados. |
customerInsightsGroup |
O nome do cliente para quem está planejado. Esse é um valor definido pelo usuário. |
locationCountryFilters[] |
Se os atributos SUB_COUNTRY_LOCATION forem uma das dimensões solicitadas e esse campo estiver presente, os atributos SUB_COUNTRY_LOCATION retornados serão localizados nesses países. Se este 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 ( |
Campos | |
---|---|
attributes[] |
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.