- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- KeywordPlanKeywordAnnotation
- KeywordAndUrlSeed
- KeywordSeed
- UrlSeed
- SiteSeed
- GenerateKeywordIdeaResult
- KeywordAnnotations
- KeywordConcept
- ConceptGroup
- KeywordPlanConceptGroupType
- Testen!
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 | |
---|---|
customer |
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 ( |
Felder | |
---|---|
geo |
Die Ressourcennamen des Zielstandorts. Maximal 10. Eine leere Liste kann verwendet werden, um alle Zielregionen anzugeben. |
include |
Wenn „true“ (wahr) festgelegt ist, werden Keywords für Erwachsene in die Antwort eingeschlossen. Der Standardwert ist "false". |
page |
Token der Seite, die abgerufen werden soll. Wenn keine Angabe erfolgt, wird die erste Ergebnisseite zurückgegeben. Verwenden Sie den Wert von |
page |
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. |
keyword |
Targeting-Netzwerk. Wenn nicht festgelegt, wird das Google-Suchnetzwerk und das Netzwerk von Partnern verwendet. |
keyword |
Die Keyword-Hinweise, die in die Antwort aufgenommen werden sollen. |
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. |
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: |
|
keyword |
Ein Keyword und eine bestimmte URL, um Ideen zu generieren, z. B. „Autos“, www.beispiel.de/autos. |
keyword |
Ein Keyword oder eine Wortgruppe, anhand derer Ideen generiert werden sollen, z. B. „Autos“. |
url |
Eine bestimmte URL, anhand derer Ideen generiert werden sollen, z. B. www.beispiel.de/autos. |
site |
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 ( |
Felder | |
---|---|
results[] |
Ergebnisse der Keyword-Ideengenerierung |
aggregate |
Die zusammengefassten Messwerte für alle Keyword-Ideen. |
next |
Paginierungstoken, mit dem die nächste Ergebnisseite abgerufen wird. Übergeben Sie den Inhalt dieses Strings als |
total |
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[] |
Es sind mindestens ein und höchstens 20 Keywords erforderlich. |
url |
Die URL, die gecrawlt werden soll, um Keyword-Ideen zu generieren. |
KeywordSeed
Keyword-Seed
JSON-Darstellung |
---|
{ "keywords": [ string ] } |
Felder | |
---|---|
keywords[] |
Es sind mindestens ein und höchstens 20 Keywords erforderlich. |
UrlSeed
URL-Seed
JSON-Darstellung |
---|
{ "url": string } |
Felder | |
---|---|
url |
Die URL, die gecrawlt werden soll, um Keyword-Ideen zu generieren. |
SiteSeed
Website-Seed
JSON-Darstellung |
---|
{ "site": string } |
Felder | |
---|---|
site |
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 ( |
Felder | |
---|---|
keyword |
Die bisherigen Messwerte für das Keyword. |
keyword |
Die Anmerkungen für das Keyword. Die Anmerkungsdaten werden nur auf Anfrage bereitgestellt. |
close |
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 |
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 ( |
Felder | |
---|---|
concepts[] |
Die Liste der Konzepte für das Keyword. |
KeywordConcept
Das Konzept für das Keyword.
JSON-Darstellung |
---|
{
"name": string,
"conceptGroup": {
object ( |
Felder | |
---|---|
name |
Der Begriffsname für das Keyword in der Konzeptgruppe. |
concept |
Die Konzeptgruppe der Konzeptdetails. |
ConceptGroup
Die Konzeptgruppe für das Keyword-Konzept.
JSON-Darstellung |
---|
{
"name": string,
"type": enum ( |
Felder | |
---|---|
name |
Der Name der Konzeptgruppe. |
type |
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. |