Method: customers.generateKeywordHistoricalMetrics

返回关键字历史指标的列表。

抛出的错误列表：AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

HTTP 请求

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

要获取历史指标的关键字列表。由于近似重复删除，系统不会返回所有输入。例如，如果请求“car”和“cars”的统计信息，则系统只会返回“car”。最多可以使用 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 Overview。

GenerateKeywordHistoricalMetricsResult

生成关键字历史指标的结果。

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

string

所请求关键字的紧密变体列表，其统计信息会合并到此 GenerateKeywordHistoricalMetricsResult 中。
keywordMetrics

object (KeywordPlanHistoricalMetrics)

文字及其近似变体的过往指标
text

string

与一个或多个关键字关联的查询文本。请注意，我们会删除关键字列表中的重复项，并移除紧密变体形式，然后再将关键字作为文本返回。例如，如果您的请求原来包含关键字“汽车”和“汽车”，则返回的搜索查询将仅包含“汽车”。去重后的查询列表将包含在 closeVariants 字段中。