- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- GenerateKeywordHistoricalMetricsResult
- Testen!
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/v14/customers/{customerId}:generateKeywordHistoricalMetrics
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
customerId |
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 ( |
Felder | |
---|---|
keywords[] |
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 |
Bei „true“ werden nicht jugendfreie Keywords in die Antwort aufgenommen. Der Standardwert ist "false". |
geoTargetConstants[] |
Die Ressourcennamen des Zielstandorts. Der Höchstwert ist 10. Wenn alle geografischen Ausrichtungen angegeben werden sollen, kann eine leere Liste verwendet werden. |
keywordPlanNetwork |
Ausrichtung auf Werbenetzwerk. Wenn die Richtlinie nicht konfiguriert ist, wird das Such- und Partner-Netzwerk von Google verwendet. |
aggregateMetrics |
Die Aggregatfelder, die als Antwort verwendet werden sollen. |
historicalMetricsOptions |
Die Optionen für bisherige Messwertdaten. |
language |
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 ( |
Felder | |
---|---|
results[] |
Liste mit Keywords und ihren bisherigen Messwerten. |
aggregateMetricResults |
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 ( |
Felder | |
---|---|
closeVariants[] |
Die Liste der nahen Varianten der angeforderten Keywords, deren Statistiken in diesem GenerateKeywordHistoryMetricsResult kombiniert werden. |
keywordMetrics |
Bisherige Messwerte für Text und ähnliche Varianten |
text |
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. |