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

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

部分一致/完全一致/フレーズ一致の候補の 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}