Method: customers.generateAdGroupThemes

Zwraca listę sugerowanych grup reklam i sugerowanych modyfikacji (tekst, typ dopasowania) dla podanych słów kluczowych.

Lista zgłoszonych błędów: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

To pole jest wymagane. Identyfikator klienta.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "keywords": [
    string
  ],
  "adGroups": [
    string
  ]
}
Pola
keywords[]

string

To pole jest wymagane. Lista słów kluczowych do zgrupowania w podanych grupach reklam.
adGroups[]

string

To pole jest wymagane. Lista nazw zasobów grup reklam, w które mają być grupowane słowa kluczowe. Format nazwy zasobu: customers/{customerId}/adGroups/{adGroupId}

Treść odpowiedzi

Wiadomość z odpowiedzią na temat: KeywordPlanIdeaService.GenerateAdGroupThemes.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "adGroupKeywordSuggestions": [
    {
      object (AdGroupKeywordSuggestion)
    }
  ],
  "unusableAdGroups": [
    {
      object (UnusableAdGroup)
    }
  ]
}
Pola
adGroupKeywordSuggestions[]

object (AdGroupKeywordSuggestion)

Lista sugerowanych par grup reklam i słów kluczowych.
unusableAdGroups[]

object (UnusableAdGroup)

Lista podanych grup reklam, których nie można użyć jako sugestii.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

AdGroupKeywordSuggestion

Sugerowany tekst i połączenie grupy reklam z kampanią dla danego słowa kluczowego.

Zapis JSON 
{
  "keywordText": string,
  "suggestedKeywordText": string,
  "suggestedMatchType": enum (KeywordMatchType),
  "suggestedAdGroup": string,
  "suggestedCampaign": string
}
Pola
keywordText

string

Oryginalny tekst słowa kluczowego.
suggestedKeywordText

string

Znormalizowana wersja parametru keywordText na potrzeby sugestii SZEROKIEJ, DOKŁADNEJ lub WYRAŻENIA.
suggestedMatchType

enum (KeywordMatchType)

Sugerowany typ dopasowania słowa kluczowego.
suggestedAdGroup

string

Sugerowana grupa reklam dla słowa kluczowego. Format nazwy zasobu: customers/{customerId}/adGroups/{adGroupId}
suggestedCampaign

string

Kampania sugerowana dla słowa kluczowego. Format nazwy zasobu: customers/{customerId}/campaigns/{campaignId}

UnusableAdGroup

Para grupy reklam i kampanii, której nie można użyć jako sugestii słów kluczowych.

Używanie grup reklam może nie być możliwe, jeśli

  • należy do kampanii, która nie jest WŁĄCZONA lub WSTRZYMANA
  • sama nie jest WŁĄCZONA
Zapis JSON 
{
  "adGroup": string,
  "campaign": string
}
Pola
adGroup

string

Nazwa zasobu grupy reklam. Format nazwy zasobu: customers/{customerId}/adGroups/{adGroupId}
campaign

string

Nazwa zasobu kampanii. Format nazwy zasobu: customers/{customerId}/campaigns/{campaignId}