Method: customers.searchAudienceInsightsAttributes

搜索可用于生成数据洞见的受众群体属性。

抛出的错误列表：AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
customerId

string

必需。客户的 ID。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "queryText": string,
  "customerInsightsGroup": string,
  "locationCountryFilters": [
    {
      object (LocationInfo)
    }
  ]
}
字段
dimensions[]

enum (AudienceInsightsDimension)

必需。要返回的属性类型。
queryText

string

必需。自由文本查询。如果请求的维度包含 CATEGORY 或 KNOWLEDGE_GRAPH 属性，则针对这些维度返回的属性将与该字符串匹配或相关。对于其他维度，系统会忽略此字段，并返回所有可用的属性。
customerInsightsGroup

string

为其规划的客户的名称。这是用户定义的值。
locationCountryFilters[]

object (LocationInfo)

如果 SUB_COUNTRY_LOCATION 属性是所请求的维度之一，且此字段存在，则返回的 SUB_COUNTRY_LOCATION 属性将位于这些国家/地区。如果此字段不存在，则营业地点属性不会按国家/地区进行过滤。如果未请求 SUB_COUNTRY_LOCATION 属性，则设置此字段会返回错误。

响应正文

AudienceInsightsService.ListAudienceInsightsAttributes 的响应消息。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "attributes": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ]
}
字段
attributes[]

object (AudienceInsightsAttributeMetadata)

与搜索查询匹配的属性。

授权范围

需要以下 OAuth 作用域：

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

有关详情，请参阅 OAuth 2.0 概览。