Method: customers.searchAudienceInsightsAttributes

통계를 생성하는 데 사용할 수 있는 잠재고객 속성을 검색합니다.

발생한 오류 목록: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

HTTP 요청

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

URL은 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 개요를 참고하세요.