Method: customers.generateAdGroupThemes

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

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

Żądanie HTTP

POST https://googleads.googleapis.com/v16/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 podane grupy 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

Odpowiedź na pytanie: 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 omówieniu 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 ROZSZERZONE, DOKŁADNE/WYRAŻONE.
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

Proponowana kampania 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.

Grupy reklam mogą być bezużyteczne, jeśli

  • należy do kampanii, która nie jest WŁĄCZONA lub WSTRZYMOWANA
  • 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}