Method: customers.generateKeywordHistoricalMetrics

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

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

HTTP 요청

POST https://googleads.googleapis.com/v14/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입니다. 빈 목록은 모든 타겟팅 지역을 지정하는 데 사용될 수 있습니다(MAY).
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 개요를 참고하세요.

GenerateKeywordHistoricalMetricsResult

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

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

string

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

object (KeywordPlanHistoricalMetrics)

텍스트 및 유사 검색어에 대한 이전 측정항목
text

string

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