Method: customers.generateKeywordHistoricalMetrics

傳回關鍵字歷來指標清單。

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

HTTP 要求

POST https://googleads.googleapis.com/v14/customers/{customerId}:generateKeywordHistoricalMetrics

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

路徑參數

參數
customerId

string

提供建議的客戶 ID。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "keywords": [
    string
  ],
  "includeAdultKeywords": boolean,
  "geoTargetConstants": [
    string
  ],
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "aggregateMetrics": {
    object (KeywordPlanAggregateMetrics)
  },
  "historicalMetricsOptions": {
    object (HistoricalMetricsOptions)
  },
  "language": string
}
欄位
keywords[]

string

用來取得歷來指標的關鍵字清單。並非所有輸入內容都會傳回近似的簡化結果。舉例來說，如果要求「汽車」和「汽車」的統計資料，則系統只會傳回「汽車」。最多只能使用 10,000 個關鍵字。
includeAdultKeywords

boolean

若為 true，則會在回應中加入成人關鍵字。預設值為 false。
geoTargetConstants[]

string

目標位置的資源名稱。上限為 10。空白清單「或許」可用來指定所有指定地理區域。
keywordPlanNetwork

enum (KeywordPlanNetwork)

指定聯播網。如未設定，則會使用 Google 搜尋和合作夥伴聯播網。
aggregateMetrics

object (KeywordPlanAggregateMetrics)

要納入回應的匯總欄位。
historicalMetricsOptions

object (HistoricalMetricsOptions)

歷來指標資料的選項。
language

string

要指定語言的資源名稱。每個關鍵字都屬於某一組語言；如果其中有一種語言就會包含關鍵字。如未設定，則會包含所有關鍵字。

回應主體

KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics 的回應訊息。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "results": [
    {
      object (GenerateKeywordHistoricalMetricsResult)
    }
  ],
  "aggregateMetricResults": {
    object (KeywordPlanAggregateMetricResults)
  }
}
欄位
results[]

object (GenerateKeywordHistoricalMetricsResult)

關鍵字清單及其歷來指標。
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

所有關鍵字的匯總指標。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/adwords

詳情請參閱 OAuth 2.0 總覽。

GenerateKeywordHistoricalMetricsResult

產生關鍵字歷來指標的結果。

JSON 表示法 
{
  "closeVariants": [
    string
  ],
  "keywordMetrics": {
    object (KeywordPlanHistoricalMetrics)
  },
  "text": string
}
欄位
closeVariants[]

string

所請求關鍵字的近似變體清單，其統計資料會合併至此 GenerateKeywordHistoryMetricsResult。
keywordMetrics

object (KeywordPlanHistoricalMetrics)

文字和近似變體的歷來指標
text

string

與一或多個關鍵字相關的查詢文字。請注意，我們會取消關鍵字清單的重複項目，先刪除近似變體，然後再將關鍵字傳回文字。舉例來說，假設要求原本包含「汽車」和「汽車」這兩個關鍵字，則傳回的搜尋查詢只會包含「汽車」。排除重複查詢清單會列於 closeVariants 欄位中。