지정된 키워드에 대해 추천 광고그룹과 제안된 수정사항 (텍스트, 검색 유형)의 목록을 표시합니다.
발생하는 오류 목록: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError
HTTP 요청
POST https://googleads.googleapis.com/v16/customers/{customerId}:generateAdGroupThemes
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
customerId |
필수 항목입니다. 고객의 ID입니다. |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "keywords": [ string ], "adGroups": [ string ] } |
입력란 | |
---|---|
keywords[] |
필수 항목입니다. 제공된 광고그룹으로 그룹화할 키워드 목록입니다. |
adGroups[] |
필수 항목입니다. 키워드를 그룹화할 광고그룹의 리소스 이름 목록입니다. 리소스 이름 형식: |
응답 본문
KeywordPlanIdeaService.GenerateAdGroupThemes
의 응답 메시지입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "adGroupKeywordSuggestions": [ { object ( |
입력란 | |
---|---|
adGroupKeywordSuggestions[] |
추천 광고그룹/키워드 쌍의 목록입니다. |
unusableAdGroups[] |
제안해 드릴 수 없는 제공된 광고그룹의 목록입니다. |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/adwords
자세한 내용은 OAuth 2.0 개요를 참고하세요.
AdGroupKeywordSuggestion
특정 키워드에 대한 추천 텍스트 및 광고그룹/캠페인 쌍입니다.
JSON 표현 |
---|
{
"keywordText": string,
"suggestedKeywordText": string,
"suggestedMatchType": enum ( |
입력란 | |
---|---|
keywordText |
원본 키워드 텍스트입니다. |
suggestedKeywordText |
BROAD/EXACT/PHRASE 추천에 대한 keywordText의 정규화된 버전입니다. |
suggestedMatchType |
추천 키워드 검색 유형입니다. |
suggestedAdGroup |
키워드에 대한 추천 광고그룹입니다. 리소스 이름 형식: |
suggestedCampaign |
키워드에 대해 제안된 캠페인입니다. 리소스 이름 형식: |
UnusableAdGroup
키워드 추천으로 사용할 수 없는 광고그룹/캠페인 쌍입니다.
AdGroup을 사용할 수 없는 경우 AdGroup을
- 운영중 또는 일시중지 상태가 아닌 캠페인에 속해 있습니다.
- 자체적으로 ENABLED 상태가 아님
JSON 표현 |
---|
{ "adGroup": string, "campaign": string } |
입력란 | |
---|---|
adGroup |
광고그룹 리소스 이름입니다. 리소스 이름 형식: |
campaign |
캠페인 리소스 이름입니다. 리소스 이름 형식: |