Method: customers.generateKeywordIdeas

Gibt eine Liste mit Keyword-Ideen zurück.

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

HTTP-Anfrage

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

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 
{
  "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 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.
includeAdultKeywords

boolean

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

string

Token der abzurufenden Seite. Wenn nicht angegeben, wird die erste Ergebnisseite zurückgegeben. Verwenden Sie den Wert aus nextPageToken in der vorherigen Antwort, um die nächste Ergebnisseite anzufordern. Die Anfragefelder müssen seitenübergreifend ü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 „pageSize“ diesen Wert überschreitet, wird der Wert ignoriert. Wenn keine Vorgabe erfolgt, werden maximal 10.000 Ergebnisse zurückgegeben. Der Server kann entscheiden, die Anzahl der zurückgegebenen Ressourcen weiter zu begrenzen. Wenn die Antwort weniger als 10.000 Ergebnisse enthält,wird sie möglicherweise nicht als letzte Seite der Ergebnisse angenommen.
keywordPlanNetwork

enum (KeywordPlanNetwork)

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

enum (KeywordPlanKeywordAnnotation)

Die Keyword-Anmerkungen, die als Antwort eingefügt werden sollen.
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.
Union-Feld seed. Der Seed-Typ, mit dem Keyword-Ideen generiert werden. Für seed ist nur einer der folgenden Werte zulässig:
keywordAndUrlSeed

object (KeywordAndUrlSeed)

Ein Keyword und eine spezifische URL zum Generieren von Ideen zum Beispiel „autos“, www.beispiel.de/autos.
keywordSeed

object (KeywordSeed)

Ein Keyword oder eine Wortgruppe zur Generierung von Ideen, beispielsweise „Autos“.
urlSeed

object (UrlSeed)

Eine spezifische URL zum Generieren von Ideen, z. B. www.beispiel.de/autos.
siteSeed

object (SiteSeed)

Die Website, auf der Ideen generiert werden sollen (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 des Generierens von Keyword-Ideen
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

Die zusammengefassten Messwerte für alle Keyword-Ideen
nextPageToken

string

Das Paginierungstoken zum Abrufen der nächsten Ergebnisseite. Übergeben Sie den Inhalt dieses Strings als pageToken-Attribut der nächsten Anfrage. nextPageToken wird für die letzte Seite nicht 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 in der Übersicht über OAuth 2.0.

KeywordPlanKeywordAnnotation

Listet die Annotationen des Keyword-Plans auf, die angefordert werden können.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Der Wert ist in dieser Version unbekannt.
KEYWORD_CONCEPT Gibt die Daten für das Keyword-Konzept und die Konzeptgruppe zurück.

KeywordAndUrlSeed

Quelltext für Keyword und URL

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

string

Erfordert mindestens ein Keyword.
url

string

Die URL, die zum Generieren von Keyword-Ideen gecrawlt werden soll.

KeywordSeed

Quelltext für Keyword

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

string

Erfordert mindestens ein Keyword.

UrlSeed

URL-Seed

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

string

Die URL, die zum Generieren von Keyword-Ideen gecrawlt werden soll.

SiteSeed

Website-Seed

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

string

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

GenerateKeywordIdeaResult

Das Ergebnis der Generierung von Keyword-Ideen.

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

object (KeywordPlanHistoricalMetrics)

Bisherige Messwerte für das Keyword
keywordAnnotations

object (KeywordAnnotations)

Die Anmerkungen für das Keyword. Die Anmerkungsdaten werden nur angegeben, wenn sie angefordert werden.
closeVariants[]

string

Liste der nahen Varianten der angeforderten Keywords, die in diesem GenerateKeywordIdeaResult-Objekt kombiniert werden Die 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 des Keyword-Plans ist dieser Text möglicherweise kein tatsächliches Keyword, sondern die kanonische Form mehrerer Keywords. Sehen Sie sich die Nachricht „KeywordPlanKeywordHistorMetrics“ im KeywordPlanService an.

KeywordAnnotations

Die Anmerkungen für die Keywords des Keyword-Plans.

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 Konzeptname für das Keyword in der conceptGroup.
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 Konzeptgruppentyp.

KeywordPlanConceptGroupType

Zählt Gruppentypen für Keyword-Plan-Konzepte auf.

Enums
UNSPECIFIED Die Klassifizierung der Konzeptgruppe unterscheidet sich von der Klassifizierung "Marke"/"ohne Markenbezug". Dies ist ein Catchall-Bucket für alle Klassifizierungen, die keine der unten genannten Optionen sind.
UNKNOWN Der Wert ist in dieser Version unbekannt.
BRAND Die Klassifizierung der Konzeptgruppe basiert auf BRAND.
OTHER_BRANDS Die Konzeptgruppenklassifizierung basierend auf BRAND, die nicht gut zu den BRAND-Klassifizierungen passte. Dies sind in der Regel Ausreißer und können bei dieser Art der Klassifizierung nur sehr wenige Keywords enthalten.
NON_BRAND Diese Klassifizierung von Konzeptgruppen basiert nicht auf BRAND. Dieser Wert wird für allgemeine Keywords ohne Markenverknüpfung zurückgegeben.