Method: customers.generateKeywordHistoricalMetrics

キーワードの過去の指標のリストを返します。

スローされるエラーのリスト: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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

1 つ以上のキーワードに関連付けられたクエリのテキスト。キーワードリストは重複が除去され、類似パターンが除外されたうえでテキストとして返されます。たとえば、元のリクエストに「car」と「cars」というキーワードが含まれていた場合、返される検索クエリには「cars」のみが含まれます。重複除去されたクエリのリストは、closeVariants フィールドに含まれます。