返回关键字历史指标列表。
抛出的错误列表:AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError
HTTP 请求
POST https://googleads.googleapis.com/v15/customers/{customerId}:generateKeywordHistoricalMetrics
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
customerId |
采纳建议的客户的 ID。 |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{ "keywords": [ string ], "includeAdultKeywords": boolean, "geoTargetConstants": [ string ], "keywordPlanNetwork": enum ( |
字段 | |
---|---|
keywords[] |
用于获取历史指标的关键字列表。并非所有输入都会因近乎精确的重复信息删除而返回。例如,如果请求“car”和“cars”的统计信息,则仅会返回“car”。最多可以使用 10,000 个关键字。 |
includeAdultKeywords |
如果为 true,则响应中将包含成人关键字。默认值为 false。 |
geoTargetConstants[] |
要定位到的营业地点的资源名称。最大值为 10。可以使用空列表来指定所有定位的地理位置。 |
keywordPlanNetwork |
定位广告网络。如果未设置此政策,系统将使用 Google 搜索网络和合作伙伴网络。 |
aggregateMetrics |
要在响应中包含的汇总字段。 |
historicalMetricsOptions |
历史指标数据的选项。 |
language |
要定位的语言的资源名称。每个关键字都属于一组语言;如果某个关键字是关键字的一种语言,则该关键字会被包含在内。如果未设置,则将包括所有关键字。 |
响应正文
KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics
的响应消息。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{ "results": [ { object ( |
字段 | |
---|---|
results[] |
关键字及其历史指标的列表。 |
aggregateMetricResults |
所有关键字的汇总指标。 |
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/adwords
有关详情,请参阅 OAuth 2.0 概览。
GenerateKeywordHistoricalMetricsResult
关键字历史指标的生成结果。
JSON 表示法 |
---|
{
"closeVariants": [
string
],
"keywordMetrics": {
object ( |
字段 | |
---|---|
closeVariants[] |
所请求关键字的紧密变体形式列表,其统计信息已合并到此 GenerateKeywordKeywordMetricsResult 中。 |
keywordMetrics |
文字及其紧密变体的历史指标 |
text |
与一个或多个关键字相关联的查询文本。请注意,我们会删除重复的关键字列表,删除紧密变体形式,然后再以文本形式返回关键字。例如,如果您的请求最初包含关键字“car”和“cars”,返回的搜索查询将仅包含“cars”。去重查询的列表将包含在 closeVariants 字段中。 |