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

Wymagane. Identyfikator klienta.

Treść żądania

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

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

string

Wymagane. Lista słów kluczowych, które mają zostać pogrupowane w podanych grupach reklam.
adGroups[]

string

Wymagane. Lista nazw zasobów grup reklam, w których można grupować słowa kluczowe. Format nazwy zasobu: customers/{customerId}/adGroups/{adGroupId}

Treść odpowiedzi

Wiadomość z odpowiedzią dla: 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 grupa reklam / słowo kluczowe.
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 sparowanie grupy reklam z kampanią w przypadku 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 keywordText w przypadku sugestii w dopasowaniu przybliżonym, dokładnym i do 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 tego słowa kluczowego. Format nazwy zasobu: customers/{customerId}/campaigns/{campaignId}

UnusableAdGroup

Para „grupa reklam / kampania”, której nie można użyć jako sugestii słów kluczowych.

Grupy reklam mogą nie być użyte, jeśli grupa reklam

  • należy do kampanii, która nie jest WŁĄCZONA ani WSZCZEPIONA;
  • Sama nie jest WŁĄCZONA
Zapis JSON 
{
  "adGroup": string,
  "campaign": string
}
Pola
adGroup

string

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

string

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