Method: customers.searchAudienceInsightsAttributes

搜尋可用來產生洞察資料的目標對象屬性。

擲回錯誤清單：AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

HTTP 要求

POST https://googleads.googleapis.com/v14/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 總覽。