Method: customers.generateAdGroupThemes

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

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

HTTP リクエスト

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

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

パスパラメータ

パラメータ
customerId

string

必須。顧客の ID。

リクエスト本文

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

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

string

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

string

必須。キーワードをグループ化する広告グループのリソース名のリスト。リソース名の形式: 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

部分一致/EXACT/PHRASE 候補の keywordsText の正規化バージョン。
suggestedMatchType

enum (KeywordMatchType)

キーワード候補のマッチタイプです。
suggestedAdGroup

string

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

string

キーワードの推奨キャンペーンです。リソース名の形式: customers/{customerId}/campaigns/{campaignId}

UnusableAdGroup

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

その広告グループは、

  • 有効または一時停止されていないキャンペーンに属している
  • それ自体は有効になっていません
JSON 表現 
{
  "adGroup": string,
  "campaign": string
}
フィールド
adGroup

string

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

string

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