Method: customers.generateKeywordHistoricalMetrics

Gibt eine Liste mit bisherigen Messwerten für Keywords zurück.

Liste der ausgelösten Fehler: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

HTTP-Anfrage

POST https://googleads.googleapis.com/v15/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 mit Keywords, um bisherige Messwerte abzurufen. Bei einer nahezu genauen Deduplizierung werden nicht alle Eingaben zurückgegeben. Wenn beispielsweise Statistiken für „Auto“ und „Autos“ angefordert werden, wird nur „car“ zurückgegeben. Es können maximal 10.000 Keywords verwendet werden.
includeAdultKeywords

boolean

Bei „true“ werden nicht jugendfreie Keywords in die Antwort aufgenommen. Der Standardwert ist "false".
geoTargetConstants[]

string

Die Ressourcennamen des Zielstandorts. Der Höchstwert ist 10. Wenn alle geografischen Ausrichtungen angegeben werden sollen, kann eine leere Liste verwendet werden.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Ausrichtung auf Werbenetzwerk. Wenn die Richtlinie nicht konfiguriert ist, wird das Such- und Partner-Netzwerk von Google verwendet.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

Die Aggregatfelder, die als Antwort verwendet werden sollen.
historicalMetricsOptions

object (HistoricalMetricsOptions)

Die Optionen für bisherige Messwertdaten.
language

string

Der Ressourcenname der Zielsprache. Jedes Keyword gehört zu einer Gruppe von Sprachen. Ein Keyword wird eingeschlossen, wenn die Sprache eine der Sprachen ist. Wenn die Richtlinie nicht konfiguriert ist, werden alle Keywords einbezogen.

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 mit Keywords und ihren bisherigen Messwerten.
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 in der Übersicht über OAuth 2.0.

GenerateKeywordHistoricalMetricsResult

Das Ergebnis der Generierung von bisherigen Messwerten für Keywords.

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

string

Die Liste der nahen Varianten der angeforderten Keywords, deren Statistiken in diesem GenerateKeywordHistoryMetricsResult kombiniert werden.
keywordMetrics

object (KeywordPlanHistoricalMetrics)

Bisherige Messwerte für Text und ähnliche Varianten
text

string

Der Text der Anfrage, der mit einem oder mehreren Keywords verknüpft ist. Hinweis: Wir deduplizieren Ihre Keyword-Liste, indem wir nahe Varianten entfernen, 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 Abfragen wird im Feld „closeVariants“ aufgeführt.