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/v15/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. Der Höchstwert ist 10. Wenn alle geografischen Ausrichtungen angegeben werden sollen, kann eine leere Liste verwendet werden.
includeAdultKeywords

boolean

Bei „true“ 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. Um die nächste Ergebnisseite anzufordern, verwenden Sie den Wert von nextPageToken in der vorherigen Antwort. 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 er 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 nicht davon ausgegangen, dass es sich um die letzte Ergebnisseite handelt.
keywordPlanNetwork

enum (KeywordPlanNetwork)

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

enum (KeywordPlanKeywordAnnotation)

Die Schlüsselwortanmerkungen, die als Antwort eingefügt werden sollen.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

Die Aggregatfelder, die als Antwort verwendet werden sollen.
historicalMetricsOptions

object (HistoricalMetricsOptions)

Die Optionen für bisherige Messwertdaten.
language

string

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.
Union-Feld seed. Der Seed-Typ für die Generierung von Keyword-Ideen. Für seed ist nur einer der folgenden Werte zulässig:
keywordAndUrlSeed

object (KeywordAndUrlSeed)

Ein Keyword und eine spezifische URL zum Generieren von Ideen, beispielsweise „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 der Generierung von Keyword-Ideen
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

Die zusammengefassten Messwerte für alle Keyword-Ideen
nextPageToken

string

Das Paginierungstoken, das zum Abrufen der nächsten Ergebnisseite verwendet wird. Ü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 Annotationen für Keyword-Plan 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

Keyword- und URL-Seed

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

string

Erfordert mindestens ein Keyword.
url

string

Die URL, die gecrawlt werden soll, um eine Auswahl von Keywords zu generieren.

KeywordSeed

Keyword-Seed

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

string

Erfordert mindestens ein Keyword.

UrlSeed

URL-Seed

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

string

Die URL, die gecrawlt werden soll, um eine Auswahl von Keywords 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 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 bereitgestellt, wenn sie angefordert werden.
closeVariants[]

string

Die Liste der nahen Varianten der angeforderten Keywords, die in diesem GenerateKeywordIdeaResult 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 die bisherigen Messwerte des Keyword-Plans ist dieser Text möglicherweise kein tatsächliches Keyword, sondern die kanonische Form mehrerer Keywords. Siehe "KeywordPlanKeywordHistorMetrics"-Nachricht in KeywordPlanService.

KeywordAnnotations

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

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 markenspezifischen und nicht markenbezogenen Klassifizierung. Dies ist ein Catchall-Bucket für alle Klassifizierungen, die keine der folgenden Klassifizierungen haben.
UNKNOWN Der Wert ist in dieser Version unbekannt.
BRAND Die Klassifizierung der Konzeptgruppe basiert auf BRAND.
OTHER_BRANDS Die auf BRAND basierende Konzeptgruppenklassifizierung, die nicht gut zu den BRAND-Klassifizierungen passte. Dabei handelt es sich in der Regel um Ausreißer, die bei dieser Art der Klassifizierung nur sehr wenige Keywords enthalten können.
NON_BRAND Diese Konzeptgruppenklassifizierung basiert nicht auf BRAND. Dieser wird für allgemeine Keywords zurückgegeben, die keine Markenverknüpfung haben.