Method: customers.generateAdGroupThemes

지정된 키워드에 대한 추천 광고 그룹 및 추천 수정사항(텍스트, 검색 유형) 목록을 반환합니다.

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

HTTP 요청

POST https://googleads.googleapis.com/v16/customers/{customerId}:generateAdGroupThemes

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

경로 매개변수

매개변수
customerId

string

필수 항목입니다. 고객의 ID입니다.

요청 본문

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

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

string

필수 항목입니다. 제공된 AdGroups로 그룹화할 키워드 목록입니다.
adGroups[]

string

필수 항목입니다. 키워드를 그룹화할 AdGroup의 리소스 이름 목록입니다. 리소스 이름 형식: customers/{customerId}/adGroups/{adGroupId}

응답 본문

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

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

JSON 표현 
{
  "adGroupKeywordSuggestions": [
    {
      object (AdGroupKeywordSuggestion)
    }
  ],
  "unusableAdGroups": [
    {
      object (UnusableAdGroup)
    }
  ]
}
필드
adGroupKeywordSuggestions[]

object (AdGroupKeywordSuggestion)

추천 광고그룹/키워드 조합의 목록입니다.
unusableAdGroups[]

object (UnusableAdGroup)

추천으로 사용할 수 없는 제공된 AdGroup의 목록입니다.

승인 범위

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

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

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

AdGroupKeywordSuggestion

특정 키워드에 대한 추천 텍스트 및 광고그룹/캠페인 페어링입니다.

JSON 표현 
{
  "keywordText": string,
  "suggestedKeywordText": string,
  "suggestedMatchType": enum (KeywordMatchType),
  "suggestedAdGroup": string,
  "suggestedCampaign": string
}
필드
keywordText

string

원래 키워드 텍스트입니다.
suggestedKeywordText

string

확장검색/일치/구문검색 제안을 위한 keywordText의 정규화된 버전입니다.
suggestedMatchType

enum (KeywordMatchType)

추천 키워드 검색 유형입니다.
suggestedAdGroup

string

키워드에 추천되는 광고 그룹입니다. 리소스 이름 형식: customers/{customerId}/adGroups/{adGroupId}
suggestedCampaign

string

키워드에 대한 추천 캠페인입니다. 리소스 이름 형식: customers/{customerId}/campaigns/{campaignId}

UnusableAdGroup

키워드에 대한 추천으로 사용할 수 없는 광고그룹/캠페인 쌍입니다.

AdGroup은

  • 사용 설정 또는 일시중지 상태가 아닌 캠페인에 속해 있습니다.
  • 이(가) 자체 '사용'이 아닙니다.
JSON 표현 
{
  "adGroup": string,
  "campaign": string
}
필드
adGroup

string

광고그룹 리소스 이름입니다. 리소스 이름 형식: customers/{customerId}/adGroups/{adGroupId}
campaign

string

캠페인 리소스 이름입니다. 리소스 이름 형식: customers/{customerId}/campaigns/{campaignId}