Method: customers.generateKeywordHistoricalMetrics

키워드 이전 측정항목 목록을 반환합니다.

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

HTTP 요청

POST https://googleads.googleapis.com/v18/customers/{customerId}:generateKeywordHistoricalMetrics

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
customerId

string

추천이 있는 고객의 ID입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "keywords": [
    string
  ],
  "includeAdultKeywords": boolean,
  "geoTargetConstants": [
    string
  ],
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "aggregateMetrics": {
    object (KeywordPlanAggregateMetrics)
  },
  "historicalMetricsOptions": {
    object (HistoricalMetricsOptions)
  },
  "language": string
}
필드
keywords[]

string

이전 측정항목을 가져올 키워드 목록입니다. 거의 정확한 중복 삭제의 결과로 모든 입력이 반환되는 것은 아닙니다. 예를 들어 '자동차' 및 '자동차'의 통계를 요청하면 '자동차'만 반환됩니다. 키워드는 최대 10,000개까지 사용할 수 있습니다.
includeAdultKeywords

boolean

true인 경우 응답에 성인 키워드가 포함됩니다. 기본값은 false입니다.
geoTargetConstants[]

string

타겟팅할 위치의 리소스 이름입니다. 최댓값은 10입니다. 빈 목록은 모든 타겟팅 지역을 지정하는 데 사용할 수 있습니다.
keywordPlanNetwork

enum (KeywordPlanNetwork)

타겟팅 네트워크 설정하지 않으면 Google 검색 및 파트너 네트워크가 사용됩니다.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

응답에 포함할 집계 필드입니다.
historicalMetricsOptions

object (HistoricalMetricsOptions)

이전 측정항목 데이터의 옵션입니다.
language

string

타겟팅할 언어의 리소스 이름입니다. 각 키워드는 일부 언어 집합에 속합니다. 언어가 키워드의 언어 중 하나인 경우 키워드가 포함됩니다. 설정하지 않으면 모든 키워드가 포함됩니다.

응답 본문

KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "results": [
    {
      object (GenerateKeywordHistoricalMetricsResult)
    }
  ],
  "aggregateMetricResults": {
    object (KeywordPlanAggregateMetricResults)
  }
}
필드
results[]

object (GenerateKeywordHistoricalMetricsResult)

키워드 목록 및 이전 측정항목
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

모든 키워드의 집계 측정항목입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 OAuth 2.0 Overview를 참고하세요.

GenerateKeywordHistoricalMetricsResult

키워드 이전 측정항목 생성 결과입니다.

JSON 표현 
{
  "closeVariants": [
    string
  ],
  "keywordMetrics": {
    object (KeywordPlanHistoricalMetrics)
  },
  "text": string
}
필드
closeVariants[]

string

요청된 키워드의 유사 검색어 목록으로, 통계가 이 GenerateKeywordHistoricalMetricsResult에 결합됩니다.
keywordMetrics

object (KeywordPlanHistoricalMetrics)

텍스트 및 유사한 변형에 대한 이전 측정항목
text

string

하나 이상의 키워드와 연결된 검색어 텍스트입니다. Google에서는 키워드 목록의 중복을 제거하여 유사한 변형을 삭제한 후 키워드를 텍스트로 반환합니다. 예를 들어 요청에 원래 '자동차'와 'cars'라는 키워드가 포함된 경우 반환된 검색어에는 'cars'만 포함됩니다. 중복 삭제된 쿼리 목록은 closeVariants 필드에 포함됩니다.