- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- GenerateKeywordHistoricalMetricsResult
- Testen!
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 | |
---|---|
customer |
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 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. |
include |
Wenn „true“ (wahr) festgelegt ist, werden Keywords für Erwachsene in die Antwort eingeschlossen. Der Standardwert ist "false". |
geo |
Die Ressourcennamen des Zielstandorts. Maximal 10. Eine leere Liste kann verwendet werden, um alle Zielregionen anzugeben. |
keyword |
Targeting-Netzwerk. Wenn nicht festgelegt, wird das Google-Suchnetzwerk und das Netzwerk von Partnern verwendet. |
aggregate |
Die Summenfelder, die in der Antwort enthalten sein sollen. |
historical |
Die Optionen für Verlaufsmesswerte. |
language |
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 ( |
Felder | |
---|---|
results[] |
Liste der Keywords und ihrer bisherigen Messwerte. |
aggregate |
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 ( |
Felder | |
---|---|
close |
Die Liste der ähnlichen Varianten der angeforderten Keywords, deren Statistiken in diesem GenerateKeywordHistoricalMetricsResult kombiniert werden. |
keyword |
Die bisherigen Messwerte für Text und ähnliche Varianten |
text |
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. |