Method: customers.generateAdGroupThemes

針對指定關鍵字，傳回建議的廣告群組和建議修改項目 (文字、比對類型) 清單。

擲回錯誤清單：AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
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

無法用於關鍵字建議的廣告群組/廣告活動組合。

如果廣告群組已啟用，可能無法使用廣告群組

  • 所屬的廣告活動尚未啟用或已暫停
  • 本身未啟用
JSON 表示法 
{
  "adGroup": string,
  "campaign": string
}
欄位
adGroup

string

廣告群組資源名稱。資源名稱格式：customers/{customerId}/adGroups/{adGroupId}
campaign

string

廣告活動資源名稱。資源名稱格式：customers/{customerId}/campaigns/{campaignId}