Method: customers.searchAudienceInsightsAttributes

分析情報の生成に使用できるオーディエンス属性を検索します。

スローされるエラーのリスト: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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 属性がリクエストされたディメンションの 1 つで、このフィールドが存在する場合は、これらの国の 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 の概要をご覧ください。