Method: customers.generateKeywordIdeas

키워드 아이디어 목록을 반환합니다.

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

HTTP 요청

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

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

경로 매개변수

매개변수
customerId

string

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

요청 본문

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

JSON 표현 
{
  "geoTargetConstants": [
    string
  ],
  "includeAdultKeywords": boolean,
  "pageToken": string,
  "pageSize": integer,
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "keywordAnnotation": [
    enum (KeywordPlanKeywordAnnotation)
  ],
  "aggregateMetrics": {
    object (KeywordPlanAggregateMetrics)
  },
  "historicalMetricsOptions": {
    object (HistoricalMetricsOptions)
  },
  "language": string,

  // Union field seed can be only one of the following:
  "keywordAndUrlSeed": {
    object (KeywordAndUrlSeed)
  },
  "keywordSeed": {
    object (KeywordSeed)
  },
  "urlSeed": {
    object (UrlSeed)
  },
  "siteSeed": {
    object (SiteSeed)
  }
  // End of list of possible types for union field seed.
}
필드
geoTargetConstants[]

string

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

boolean

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

string

가져올 페이지의 토큰입니다. 지정하지 않으면 결과의 첫 페이지가 표시됩니다. 결과의 다음 페이지를 요청하려면 이전 응답의 nextPageToken에서 가져온 값을 사용합니다. 요청 필드는 페이지 간에 일치해야 합니다.
pageSize

integer

단일 페이지에서 검색할 결과 수입니다. 최대 10,000개의 결과가 반환될 수 있으며, pageSize가 이를 초과하면 무시됩니다. 지정하지 않으면 최대 10,000개의 결과가 반환됩니다. 서버는 반환되는 리소스 수를 추가로 제한할 수 있습니다. 응답에 포함된 결과가 10,000개 미만이면 결과의 마지막 페이지로 간주되지 않을 수 있습니다.
keywordPlanNetwork

enum (KeywordPlanNetwork)

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

enum (KeywordPlanKeywordAnnotation)

응답에 포함할 키워드 주석입니다.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

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

object (HistoricalMetricsOptions)

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

string

타겟팅할 언어의 리소스 이름입니다. 각 키워드는 몇 가지 언어에 속합니다. 언어가 해당 언어 중 하나이면 키워드도 포함됩니다. 설정하지 않으면 모든 키워드가 포함됩니다.
통합 필드 seed. 키워드 아이디어를 생성할 시드 유형입니다. seed은 다음 중 하나여야 합니다.
keywordAndUrlSeed

object (KeywordAndUrlSeed)

아이디어를 생성할 키워드 및 특정 URL(예: www.example.com/cars).
keywordSeed

object (KeywordSeed)

아이디어를 생성하는 키워드 또는 문구입니다(예: 자동차).
urlSeed

object (UrlSeed)

아이디어를 생성할 특정 URL(예: www.example.com/cars)
siteSeed

object (SiteSeed)

아이디어를 생성할 사이트입니다(예: www.example.com).

응답 본문

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

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

JSON 표현 
{
  "results": [
    {
      object (GenerateKeywordIdeaResult)
    }
  ],
  "aggregateMetricResults": {
    object (KeywordPlanAggregateMetricResults)
  },
  "nextPageToken": string,
  "totalSize": string
}
필드
results[]

object (GenerateKeywordIdeaResult)

키워드 아이디어 생성 결과입니다.
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

모든 키워드 아이디어의 집계 측정항목입니다.
nextPageToken

string

결과의 다음 페이지를 가져오는 데 사용되는 페이지 나누기 토큰입니다. 이 문자열의 콘텐츠를 다음 요청의 pageToken 속성으로 전달합니다. 마지막 페이지에서는 nextPageToken 값이 반환되지 않습니다.
totalSize

string (int64 format)

사용 가능한 총 결과 수입니다.

승인 범위

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

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

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

KeywordPlanKeywordAnnotation

요청할 수 있는 키워드 계획 주석을 열거합니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 값을 알 수 없습니다.
KEYWORD_CONCEPT 키워드 개념 및 개념 그룹 데이터를 반환합니다.

KeywordAndUrlSeed

키워드 및 URL 시드

JSON 표현 
{
  "keywords": [
    string
  ],
  "url": string
}
필드
keywords[]

string

키워드가 하나 이상 필요합니다.
url

string

키워드 아이디어를 생성하기 위해 크롤링할 URL입니다.

KeywordSeed

키워드 시드

JSON 표현 
{
  "keywords": [
    string
  ]
}
필드
keywords[]

string

하나 이상의 키워드가 필요합니다.

UrlSeed

URL 시드

JSON 표현 
{
  "url": string
}
필드
url

string

키워드 아이디어를 생성하기 위해 크롤링할 URL입니다.

SiteSeed

사이트 시드

JSON 표현 
{
  "site": string
}
필드
site

string

사이트의 도메인 이름입니다. 아이디어를 요청하는 고객이 사이트를 소유하지 않은 경우 공개 정보만 반환됩니다.

GenerateKeywordIdeaResult

키워드 아이디어 생성의 결과입니다.

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

object (KeywordPlanHistoricalMetrics)

키워드의 이전 측정항목입니다.
keywordAnnotations

object (KeywordAnnotations)

키워드의 주석입니다. 주석 데이터는 요청된 경우에만 제공됩니다.
closeVariants[]

string

요청된 키워드의 유사 검색어 목록으로, 이 GenerateKeywordIdeaResult에 결합됩니다. '유사한 변형'의 정의는 https://support.google.com/google-ads/answer/9342105를 참고하세요.
text

string

키워드 아이디어의 텍스트입니다. 키워드 계획 이전 측정항목과 마찬가지로 이 텍스트는 실제 키워드가 아닌 여러 키워드의 표준 형식일 수 있습니다. KeywordPlanService에서 KeywordPlanKeywordHistoricalMetrics 메시지를 참조하세요.

KeywordAnnotations

키워드 계획 키워드의 주석입니다.

JSON 표현 
{
  "concepts": [
    {
      object (KeywordConcept)
    }
  ]
}
필드
concepts[]

object (KeywordConcept)

키워드의 개념 목록입니다.

KeywordConcept

키워드의 개념입니다.

JSON 표현 
{
  "name": string,
  "conceptGroup": {
    object (ConceptGroup)
  }
}
필드
name

string

conceptGroup의 키워드에 대한 개념 이름입니다.
conceptGroup

object (ConceptGroup)

개념 세부정보의 개념 그룹입니다.

ConceptGroup

키워드 개념에 대한 개념 그룹입니다.

JSON 표현 
{
  "name": string,
  "type": enum (KeywordPlanConceptGroupType)
}
필드
name

string

개념 그룹 이름입니다.
type

enum (KeywordPlanConceptGroupType)

개념 그룹 유형입니다.

KeywordPlanConceptGroupType

키워드 계획 개념 그룹 유형을 열거합니다.

열거형
UNSPECIFIED 브랜드/비브랜드와 다른 개념 그룹 분류입니다. 이는 아래에 해당하지 않는 모든 분류에 대한 catch all 버킷입니다.
UNKNOWN 이 버전에서 알 수 없는 값입니다.
BRAND 개념 그룹 분류는 BRAND를 기반으로 합니다.
OTHER_BRANDS 브랜드를 기반으로 한 개념 그룹 분류가 브랜드 분류와 잘 맞지 않았습니다. 이는 일반적으로 이상점이며 이러한 유형의 분류에는 키워드가 거의 없을 수 있습니다.
NON_BRAND 이러한 개념 그룹 분류는 BRAND를 기반으로 하지 않습니다. 브랜드 연결이 없는 일반 키워드의 경우 이 값이 반환됩니다.