Method: customers.generateAdGroupThemes

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

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

HTTP 要求

POST https://googleads.googleapis.com/v14/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

「BROAD/EXACT/PHRASE」建議的關鍵字文字正規化版本。
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}