Method: customers.generateAdGroupThemes

Gibt eine Liste mit vorgeschlagenen Anzeigengruppen und vorgeschlagenen Änderungen (Text, Keyword-Option) für die angegebenen Keywords zurück.

Liste der ausgegebenen Fehler: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customerId

string

Erforderlich. Die ID des Kunden.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

string

Erforderlich. Eine Liste von Keywords, die in den angegebenen Anzeigengruppen gruppiert werden sollen.
adGroups[]

string

Erforderlich. Eine Liste mit Ressourcennamen von Anzeigengruppen, in die Keywords gruppiert werden sollen. Format der Ressourcennamen: customers/{customerId}/adGroups/{adGroupId}

Antworttext

Antwortnachricht für KeywordPlanIdeaService.GenerateAdGroupThemes.

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

JSON-Darstellung 
{
  "adGroupKeywordSuggestions": [
    {
      object (AdGroupKeywordSuggestion)
    }
  ],
  "unusableAdGroups": [
    {
      object (UnusableAdGroup)
    }
  ]
}
Felder
adGroupKeywordSuggestions[]

object (AdGroupKeywordSuggestion)

Eine Liste mit Vorschlägen für Anzeigengruppen-/Keyword-Kombinationen.
unusableAdGroups[]

object (UnusableAdGroup)

Eine Liste der bereitgestellten Anzeigengruppen, die nicht als Vorschläge verwendet werden konnten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

AdGroupKeywordSuggestion

Der vorgeschlagene Text und die Anzeigengruppen-/Kampagnenkombination für ein bestimmtes Keyword.

JSON-Darstellung 
{
  "keywordText": string,
  "suggestedKeywordText": string,
  "suggestedMatchType": enum (KeywordMatchType),
  "suggestedAdGroup": string,
  "suggestedCampaign": string
}
Felder
keywordText

string

Der ursprüngliche Keyword-Text
suggestedKeywordText

string

Die normalisierte Version von „keywordText“ für Vorschläge vom Typ „WEITGEHEND PASSEND“, „GENAU PASSEND“ oder „PASSENDE WORTGRUPPE“.
suggestedMatchType

enum (KeywordMatchType)

Die vorgeschlagene Keyword-Option.
suggestedAdGroup

string

Die vorgeschlagene Anzeigengruppe für das Keyword. Format der Ressourcennamen: customers/{customerId}/adGroups/{adGroupId}
suggestedCampaign

string

Die vorgeschlagene Kampagne für das Keyword Format des Ressourcennamens: customers/{customerId}/campaigns/{campaignId}

UnusableAdGroup

Ein Anzeigengruppen/Kampagnen-Paar, das nicht als Vorschlag für Keywords verwendet werden konnte.

Anzeigengruppen können möglicherweise nicht verwendet werden, wenn

  • zu einer Kampagne gehören, die nicht AKTIVIERT oder PAUSIERT ist
  • ist selbst nicht AKTIVIERT.
JSON-Darstellung 
{
  "adGroup": string,
  "campaign": string
}
Felder
adGroup

string

Der Ressourcenname der Anzeigengruppe. Format der Ressourcennamen: customers/{customerId}/adGroups/{adGroupId}
campaign

string

Der Ressourcenname der Kampagne. Format des Ressourcennamens: customers/{customerId}/campaigns/{campaignId}