Method: customers.generateAdGroupThemes

指定されたキーワードに対して、推奨される広告グループと推奨される変更（テキスト、マッチタイプ）のリストを返します。

スローされるエラーのリスト: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
customerId

string

必須。顧客の ID。

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "keywords": [
    string
  ],
  "adGroups": [
    string
  ]
}
フィールド
keywords[]

string

必須。指定した広告グループにグループ化するキーワードのリスト。
adGroups[]

string

必須。キーワードをグループ化する AdGroups のリソース名のリスト。リソース名の形式: customers/{customerId}/adGroups/{adGroupId}

レスポンスの本文

KeywordPlanIdeaService.GenerateAdGroupThemes に対するレスポンス メッセージです。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "adGroupKeywordSuggestions": [
    {
      object (AdGroupKeywordSuggestion)
    }
  ],
  "unusableAdGroups": [
    {
      object (UnusableAdGroup)
    }
  ]
}
フィールド
adGroupKeywordSuggestions[]

object (AdGroupKeywordSuggestion)

広告グループとキーワードの組み合わせの候補リストです。
unusableAdGroups[]

object (UnusableAdGroup)

候補として使用できなかった指定された広告グループのリスト。

認可スコープ

次の 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

BROAD/EXACT/PHRASE 候補の keywordText の正規化バージョン
suggestedMatchType

enum (KeywordMatchType)

推奨されるキーワードのマッチタイプ。
suggestedAdGroup

string

キーワードに対して推奨される広告グループです。リソース名の形式: customers/{customerId}/adGroups/{adGroupId}
suggestedCampaign

string

キーワードに対して推奨されるキャンペーン。リソース名の形式: customers/{customerId}/campaigns/{campaignId}

UnusableAdGroup

キーワードの候補として使用できなかった広告グループとキャンペーンのペア。

広告グループが次の条件に該当する場合、広告グループは

  • 「ENABLED」または「PAUSED」以外のキャンペーンに属している
  • が有効になっていない
JSON 表現 
{
  "adGroup": string,
  "campaign": string
}
フィールド
adGroup

string

広告グループのリソース名。リソース名の形式: customers/{customerId}/adGroups/{adGroupId}
campaign

string

キャンペーンのリソース名。リソース名の形式: customers/{customerId}/campaigns/{campaignId}