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/v16/customers/{customerId}:generateKeywordHistoricalMetrics

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameters
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

Falls wahr, werden nicht jugendfreie Keywords in die Antwort aufgenommen. Der Standardwert ist "false".
geoTargetConstants[]

string

Die Ressourcennamen des Standorts, auf den die Kampagne ausgerichtet werden soll. Der Höchstwert ist 10. Wenn alle geografischen Ausrichtungen angegeben werden sollen, kann eine leere Liste verwendet werden.
keywordPlanNetwork

enum (KeywordPlanNetwork)

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

object (KeywordPlanAggregateMetrics)

Die aggregierten Felder, die als Antwort enthalten sein sollen.
historicalMetricsOptions

object (HistoricalMetricsOptions)

Die Optionen für Verlaufsdaten von Messwerten.
language

string

Der Ressourcenname der Sprache für die Ausrichtung. 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 GenerateKeyword HistoricalMetricsResult kombiniert werden.
keywordMetrics

object (KeywordPlanHistoricalMetrics)

Bisherige Messwerte für Text und ähnliche Varianten
text

string

Der Text der Abfrage, 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 „car“ und „cars“ enthielt, enthält die zurückgegebene Suchanfrage nur „cars“. Die Liste der deduplizierten Abfragen ist im Feld „closeVariants“ enthalten.