- HTTP 요청
- 경로 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- KeywordPlanKeywordAnnotation
- KeywordAndUrlSeed
- KeywordSeed
- UrlSeed
- SiteSeed
- GenerateKeywordIdeaResult
- KeywordAnnotations
- KeywordConcept
- ConceptGroup
- KeywordPlanConceptGroupType
- 실습
키워드 아이디어 목록을 표시합니다.
발생한 오류 목록: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError KeywordPlanIdeaError QuotaError RequestError
HTTP 요청
POST https://googleads.googleapis.com/v14/customers/{customerId}:generateKeywordIdeas
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
customerId |
추천이 있는 고객의 ID입니다. |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "geoTargetConstants": [ string ], "includeAdultKeywords": boolean, "pageToken": string, "pageSize": integer, "keywordPlanNetwork": enum ( |
필드 | |
---|---|
geoTargetConstants[] |
타겟팅할 위치의 리소스 이름입니다. 최댓값은 10입니다. 빈 목록은 모든 타겟팅 지역을 지정하는 데 사용될 수 있습니다(MAY). |
includeAdultKeywords |
true인 경우 성인 키워드가 응답에 포함됩니다. 기본값은 false입니다. |
pageToken |
검색할 페이지의 토큰입니다. 지정하지 않으면 결과의 첫 페이지가 표시됩니다. 결과의 다음 페이지를 요청하려면 이전 응답의 |
pageSize |
단일 페이지에서 검색할 결과 수입니다. 최대 10,000개의 결과가 반환될 수 있으며 pageSize가 이를 초과하면 무시됩니다. 지정하지 않으면 최대 10,000개의 결과가 반환됩니다. 서버는 반환되는 리소스의 수를 추가로 제한할 수 있습니다. 응답에 포함된 결과가 10,000개 미만이면 결과의 마지막 페이지로 가정하지 않을 수 있습니다. |
keywordPlanNetwork |
네트워크를 타겟팅합니다. 설정하지 않으면 Google 검색 및 파트너 네트워크가 사용됩니다. |
keywordAnnotation[] |
응답에 포함할 키워드 주석입니다. |
aggregateMetrics |
응답에 포함할 집계 필드입니다. |
historicalMetricsOptions |
이전 측정항목 데이터의 옵션입니다. |
language |
타겟팅할 언어의 리소스 이름입니다. 각 키워드는 몇 가지 언어 집합에 해당하며, 언어가 해당 언어 중 하나인 경우 키워드가 포함됩니다. 설정하지 않으면 모든 키워드가 포함됩니다. |
통합 필드 seed . 키워드 아이디어를 생성할 시드의 유형입니다. seed 은 다음 중 하나여야 합니다. |
|
keywordAndUrlSeed |
아이디어를 생성할 키워드와 특정 URL(예: www.example.com/cars) |
keywordSeed |
아이디어를 생성할 키워드 또는 구문(예: 자동차) |
urlSeed |
아이디어를 생성할 특정 URL입니다(예: www.example.com/cars). |
siteSeed |
아이디어를 얻을 수 있는 사이트입니다(예: www.example.com). |
응답 본문
KeywordPlanIdeaService.GenerateKeywordIdeas
의 응답 메시지입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "results": [ { object ( |
필드 | |
---|---|
results[] |
키워드 아이디어 생성 결과입니다. |
aggregateMetricResults |
모든 키워드 아이디어에 대한 집계 측정항목입니다. |
nextPageToken |
결과의 다음 페이지를 검색하는 데 사용되는 페이지로 나누기 토큰입니다. 이 문자열의 콘텐츠를 다음 요청의 |
totalSize |
사용 가능한 총 결과 수입니다. |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/adwords
자세한 내용은 OAuth 2.0 개요를 참고하세요.
KeywordPlanKeywordAnnotation
요청 가능한 키워드 계획 주석을 열거합니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
이 버전에서는 알 수 없는 값입니다. |
KEYWORD_CONCEPT |
키워드 개념 및 개념 그룹 데이터를 반환합니다. |
KeywordAndUrlSeed
키워드 및 URL 시드
JSON 표현 |
---|
{ "keywords": [ string ], "url": string } |
필드 | |
---|---|
keywords[] |
키워드가 하나 이상 필요합니다. |
url |
키워드 아이디어를 생성하기 위해 크롤링할 URL입니다. |
KeywordSeed
키워드 시드
JSON 표현 |
---|
{ "keywords": [ string ] } |
필드 | |
---|---|
keywords[] |
키워드가 하나 이상 필요합니다. |
UrlSeed
URL 시드
JSON 표현 |
---|
{ "url": string } |
필드 | |
---|---|
url |
키워드 아이디어를 생성하기 위해 크롤링할 URL입니다. |
SiteSeed
사이트 시드
JSON 표현 |
---|
{ "site": string } |
필드 | |
---|---|
site |
사이트의 도메인 이름입니다. 아이디어를 요청하는 고객이 사이트의 소유자가 아닌 경우 제공된 공개 정보만 반환됩니다. |
GenerateKeywordIdeaResult
키워드 아이디어 생성의 결과입니다.
JSON 표현 |
---|
{ "keywordIdeaMetrics": { object ( |
필드 | |
---|---|
keywordIdeaMetrics |
키워드의 이전 측정항목입니다. |
keywordAnnotations |
키워드의 주석입니다. 주석 데이터는 요청된 경우에만 제공됩니다. |
closeVariants[] |
이 GenerateKeywordIdeaResult로 조합된 요청된 키워드의 유사 검색어의 목록입니다. '유사 검색어'의 정의는 https://support.google.com/google-ads/answer/9342105를 참고하세요. |
text |
키워드 아이디어의 텍스트입니다. 키워드 계획의 이전 측정항목과 마찬가지로 이 텍스트는 실제 키워드가 아니라 여러 키워드의 표준 형식입니다. KeywordPlanService에서 KeywordPlanKeywordHistoricalMetrics 메시지를 확인합니다. |
KeywordAnnotations
키워드 계획 키워드에 대한 주석입니다.
JSON 표현 |
---|
{
"concepts": [
{
object ( |
필드 | |
---|---|
concepts[] |
키워드의 개념 목록입니다. |
KeywordConcept
키워드의 개념입니다.
JSON 표현 |
---|
{
"name": string,
"conceptGroup": {
object ( |
필드 | |
---|---|
name |
conceptGroup에 있는 키워드의 개념 이름입니다. |
conceptGroup |
개념 세부정보의 개념 그룹입니다. |
ConceptGroup
키워드 개념의 개념 그룹입니다.
JSON 표현 |
---|
{
"name": string,
"type": enum ( |
필드 | |
---|---|
name |
개념 그룹 이름입니다. |
type |
개념 그룹 유형입니다. |
KeywordPlanConceptGroupType
키워드 계획 개념 그룹 유형을 열거합니다.
열거형 | |
---|---|
UNSPECIFIED |
컨셉 그룹 분류는 브랜드/비브랜드와 다릅니다. 이 버킷은 아래 항목에 해당하지 않는 모든 분류를 대상으로 합니다. |
UNKNOWN |
이 버전에서는 알 수 없는 값입니다. |
BRAND |
그룹 개념 분류는 BRAND를 기준으로 합니다. |
OTHER_BRANDS |
BRAND에 기반한 개념 그룹 분류가 BRAND 분류에 적합하지 않았습니다. 이는 일반적으로 이상점이며 이러한 유형의 분류에서는 키워드가 거의 없을 수 있습니다. |
NON_BRAND |
이러한 개념 그룹 분류는 BRAND을(를) 기준으로 하지 않습니다. 브랜드 연결이 없는 일반 키워드에 대해 반환됩니다. |