Method: customers.generateKeywordIdeas

Gibt eine Liste mit Keyword-Ideen zurück.

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

HTTP-Anfrage

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

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
{
  "geoTargetConstants": [
    string
  ],
  "includeAdultKeywords": boolean,
  "pageToken": string,
  "pageSize": integer,
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "keywordAnnotation": [
    enum (KeywordPlanKeywordAnnotation)
  ],
  "aggregateMetrics": {
    object (KeywordPlanAggregateMetrics)
  },
  "historicalMetricsOptions": {
    object (HistoricalMetricsOptions)
  },
  "language": string,

  // Union field seed can be only one of the following:
  "keywordAndUrlSeed": {
    object (KeywordAndUrlSeed)
  },
  "keywordSeed": {
    object (KeywordSeed)
  },
  "urlSeed": {
    object (UrlSeed)
  },
  "siteSeed": {
    object (SiteSeed)
  }
  // End of list of possible types for union field seed.
}
Felder
geoTargetConstants[]

string

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

includeAdultKeywords

boolean

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

pageToken

string

Token der Seite, die abgerufen werden soll. Wenn keine Angabe erfolgt, wird die erste Ergebnisseite zurückgegeben. Verwenden Sie den Wert von nextPageToken in der vorherigen Antwort, um die nächste Ergebnisseite anzufordern. Die Anfragefelder müssen auf allen Seiten übereinstimmen.

pageSize

integer

Anzahl der Ergebnisse, die auf einer einzelnen Seite abgerufen werden sollen. Es können maximal 10.000 Ergebnisse zurückgegeben werden. Wenn die pageSize diesen Wert überschreitet, wird sie ignoriert. Wenn nicht angegeben, werden maximal 10.000 Ergebnisse zurückgegeben. Der Server kann die Anzahl der zurückgegebenen Ressourcen weiter einschränken. Wenn die Antwort weniger als 10.000 Ergebnisse enthält, kann nicht davon ausgegangen werden, dass es sich um die letzte Ergebnisseite handelt.

keywordPlanNetwork

enum (KeywordPlanNetwork)

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

keywordAnnotation[]

enum (KeywordPlanKeywordAnnotation)

Die Keyword-Hinweise, die in die Antwort aufgenommen werden sollen.

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.

Union-Feld seed. Die Art des Auslösers, mit dem Keyword-Ideen generiert werden. Für seed ist nur einer der folgenden Werte zulässig:
keywordAndUrlSeed

object (KeywordAndUrlSeed)

Ein Keyword und eine bestimmte URL, um Ideen zu generieren, z. B. „Autos“, www.beispiel.de/autos.

keywordSeed

object (KeywordSeed)

Ein Keyword oder eine Wortgruppe, anhand derer Ideen generiert werden sollen, z. B. „Autos“.

urlSeed

object (UrlSeed)

Eine bestimmte URL, anhand derer Ideen generiert werden sollen, z. B. www.beispiel.de/autos.

siteSeed

object (SiteSeed)

Die Website, von der Sie Ideen generieren möchten, z. B. www.beispiel.de.

Antworttext

Antwortnachricht für KeywordPlanIdeaService.GenerateKeywordIdeas.

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

JSON-Darstellung
{
  "results": [
    {
      object (GenerateKeywordIdeaResult)
    }
  ],
  "aggregateMetricResults": {
    object (KeywordPlanAggregateMetricResults)
  },
  "nextPageToken": string,
  "totalSize": string
}
Felder
results[]

object (GenerateKeywordIdeaResult)

Ergebnisse der Keyword-Ideengenerierung

aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

Die zusammengefassten Messwerte für alle Keyword-Ideen.

nextPageToken

string

Paginierungstoken, mit dem die nächste Ergebnisseite abgerufen wird. Übergeben Sie den Inhalt dieses Strings als pageToken-Attribut der nächsten Anfrage. Für die letzte Seite wird kein nextPageToken zurückgegeben.

totalSize

string (int64 format)

Gesamtzahl der verfügbaren Ergebnisse.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

KeywordPlanKeywordAnnotation

Hier werden Anmerkungen zu Keyword-Plänen aufgelistet, die angefordert werden können.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Der Wert ist in dieser Version nicht bekannt.
KEYWORD_CONCEPT Die Daten zu Keyword-Konzepten und Konzeptgruppen zurückgeben.

KeywordAndUrlSeed

Keyword- und URL-Seed

JSON-Darstellung
{
  "keywords": [
    string
  ],
  "url": string
}
Felder
keywords[]

string

Es sind mindestens ein und höchstens 20 Keywords erforderlich.

url

string

Die URL, die gecrawlt werden soll, um Keyword-Ideen zu generieren.

KeywordSeed

Keyword-Seed

JSON-Darstellung
{
  "keywords": [
    string
  ]
}
Felder
keywords[]

string

Es sind mindestens ein und höchstens 20 Keywords erforderlich.

UrlSeed

URL-Seed

JSON-Darstellung
{
  "url": string
}
Felder
url

string

Die URL, die gecrawlt werden soll, um Keyword-Ideen zu generieren.

SiteSeed

Website-Seed

JSON-Darstellung
{
  "site": string
}
Felder
site

string

Der Domainname der Website. Wenn der Kunde, der die Ideen anfordert, nicht der Inhaber der Website ist, werden nur öffentliche Informationen zurückgegeben.

GenerateKeywordIdeaResult

Das Ergebnis der Keyword-Ideengenerierung.

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

object (KeywordPlanHistoricalMetrics)

Die bisherigen Messwerte für das Keyword.

keywordAnnotations

object (KeywordAnnotations)

Die Anmerkungen für das Keyword. Die Anmerkungsdaten werden nur auf Anfrage bereitgestellt.

closeVariants[]

string

Die Liste der ähnlichen Varianten der angeforderten Keywords, die in diesem GenerateKeywordIdeaResult kombiniert werden. Eine Definition von „ähnlichen Varianten“ finden Sie unter https://support.google.com/google-ads/answer/9342105.

text

string

Text der Keyword-Idee. Wie bei den bisherigen Messwerten für Keyword-Pläne handelt es sich dabei möglicherweise nicht um ein tatsächliches Keyword, sondern um die kanonische Form mehrerer Keywords. Siehe KeywordPlanKeywordHistoricalMetrics-Nachricht im KeywordPlanService.

KeywordAnnotations

Die Anmerkungen für die Keywords im Keyword-Plan.

JSON-Darstellung
{
  "concepts": [
    {
      object (KeywordConcept)
    }
  ]
}
Felder
concepts[]

object (KeywordConcept)

Die Liste der Konzepte für das Keyword.

KeywordConcept

Das Konzept für das Keyword.

JSON-Darstellung
{
  "name": string,
  "conceptGroup": {
    object (ConceptGroup)
  }
}
Felder
name

string

Der Begriffsname für das Keyword in der Konzeptgruppe.

conceptGroup

object (ConceptGroup)

Die Konzeptgruppe der Konzeptdetails.

ConceptGroup

Die Konzeptgruppe für das Keyword-Konzept.

JSON-Darstellung
{
  "name": string,
  "type": enum (KeywordPlanConceptGroupType)
}
Felder
name

string

Der Name der Konzeptgruppe.

type

enum (KeywordPlanConceptGroupType)

Der Typ der Konzeptgruppe.

KeywordPlanConceptGroupType

Listet die Gruppentypen für Keyword-Planungskonzepte auf.

Enums
UNSPECIFIED Die Klassifizierung der Konzeptgruppe unterscheidet sich von „Marke“ und „Nicht-Marke“. Dieser Bucket ist ein Sammeleimer für alle Klassifizierungen, die nicht zu den unten aufgeführten Kategorien gehören.
UNKNOWN Der Wert ist in dieser Version nicht bekannt.
BRAND Die Klassifizierung der Konzeptgruppe basiert auf BRAND.
OTHER_BRANDS Die Klassifizierung der Konzeptgruppe nach MARKE passte nicht gut zu den MARKEN-Klassifizierungen. Diese sind in der Regel Ausreißer und können bei dieser Art der Klassifizierung nur sehr wenige Keywords haben.
NON_BRAND Diese Klassifizierung der Konzeptgruppe basiert nicht auf der MARKE. Dieser Wert wird für allgemeine Keywords ohne Markenverknüpfung zurückgegeben.