Method: customers.generateKeywordHistoricalMetrics

Gibt eine Liste der bisherigen Messwerte für Keywords zurück.

Liste der geworfenen Fehler: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customerId

string

Die ID des Kunden mit der Empfehlung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "keywords": [
    string
  ],
  "includeAdultKeywords": boolean,
  "geoTargetConstants": [
    string
  ],
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "aggregateMetrics": {
    object (KeywordPlanAggregateMetrics)
  },
  "historicalMetricsOptions": {
    object (HistoricalMetricsOptions)
  },
  "language": string
}
Felder
keywords[]

string

Eine Liste von Keywords, für die bisherige Messwerte abgerufen werden sollen. Aufgrund der nahezu genauen Deduplizierung werden nicht alle Eingaben zurückgegeben. Wenn beispielsweise Statistiken für „Auto“ und „Autos“ angefordert werden, wird nur „Auto“ zurückgegeben. Es können maximal 10.000 Keywords verwendet werden.

includeAdultKeywords

boolean

Wenn „true“ (wahr) festgelegt ist, werden Keywords für Erwachsene in die Antwort eingeschlossen. Der Standardwert ist "false".

geoTargetConstants[]

string

Die Ressourcennamen des Zielstandorts. Maximal 10. Eine leere Liste kann verwendet werden, um alle Zielregionen anzugeben.

keywordPlanNetwork

enum (KeywordPlanNetwork)

Targeting-Netzwerk. Wenn nicht festgelegt, wird das Google-Suchnetzwerk und das Netzwerk von Partnern verwendet.

aggregateMetrics

object (KeywordPlanAggregateMetrics)

Die Summenfelder, die in der Antwort enthalten sein sollen.

historicalMetricsOptions

object (HistoricalMetricsOptions)

Die Optionen für Verlaufsmesswerte.

language

string

Der Ressourcenname der Zielsprache. Jedes Keyword gehört zu einer Reihe von Sprachen. Ein Keyword wird berücksichtigt, wenn die Sprache zu diesen gehört. Wenn Sie nichts festlegen, werden alle Keywords berücksichtigt.

Antworttext

Antwortnachricht für KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "results": [
    {
      object (GenerateKeywordHistoricalMetricsResult)
    }
  ],
  "aggregateMetricResults": {
    object (KeywordPlanAggregateMetricResults)
  }
}
Felder
results[]

object (GenerateKeywordHistoricalMetricsResult)

Liste der Keywords und ihrer bisherigen Messwerte.

aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

Die zusammengefassten Messwerte für alle Keywords.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

GenerateKeywordHistoricalMetricsResult

Das Ergebnis der Generierung bisheriger Messwerte für Keywords.

JSON-Darstellung
{
  "closeVariants": [
    string
  ],
  "keywordMetrics": {
    object (KeywordPlanHistoricalMetrics)
  },
  "text": string
}
Felder
closeVariants[]

string

Die Liste der ähnlichen Varianten der angeforderten Keywords, deren Statistiken in diesem GenerateKeywordHistoricalMetricsResult kombiniert werden.

keywordMetrics

object (KeywordPlanHistoricalMetrics)

Die bisherigen Messwerte für Text und ähnliche Varianten

text

string

Der Text der Suchanfrage, der mit einem oder mehreren Keywords verknüpft ist. Hinweis: Wir entfernen Duplikate aus Ihrer Keyword-Liste und eliminieren ähnliche Varianten, bevor die Keywords als Text zurückgegeben werden. Wenn Ihre Anfrage beispielsweise ursprünglich die Keywords „Auto“ und „Autos“ enthielt, enthält die zurückgegebene Suchanfrage nur „Autos“. Die Liste der deduplizierten Suchanfragen wird im Feld „closeVariants“ enthalten sein.