Method: customers.generateAdGroupThemes

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

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

HTTP-Anfrage

POST https://googleads.googleapis.com/v15/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 bereitgestellten Anzeigengruppen gruppiert werden sollen.
adGroups[]

string

Erforderlich. Eine Liste mit Ressourcennamen von Anzeigengruppen, in die Keywords gruppiert werden können. Format des Ressourcennamens: 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 vorgeschlagenen Kombinationen aus Anzeigengruppe und Keyword.
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

Die vorgeschlagene Kombination aus Text und Anzeigengruppe/Kampagne 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 weitgehend passende/genaue/passende Vorschläge.
suggestedMatchType

enum (KeywordMatchType)

Die vorgeschlagene Keyword-Option.
suggestedAdGroup

string

Die vorgeschlagene Anzeigengruppe für das Keyword Format des Ressourcennamens: customers/{customerId}/adGroups/{adGroupId}
suggestedCampaign

string

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

UnusableAdGroup

Eine Anzeigengruppe/Kampagne, die nicht als Vorschlag für Keywords verwendet werden konnte.

Anzeigengruppen sind möglicherweise nicht verwendbar, wenn die Anzeigengruppe

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

string

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

string

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