Method: customers.generateKeywordIdeas

Zwraca listę propozycji słów kluczowych.

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

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

Identyfikator klienta z rekomendacją.

Treść żądania

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

Zapis JSON 
{
  "geoTargetConstants": [
    string
  ],
  "includeAdultKeywords": boolean,
  "pageToken": string,
  "pageSize": integer,
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "keywordAnnotation": [
    enum (KeywordPlanKeywordAnnotation)
  ],
  "aggregateMetrics": {
    object (KeywordPlanAggregateMetrics)
  },
  "historicalMetricsOptions": {
    object (HistoricalMetricsOptions)
  },
  "language": string,

  // Union field seed can be only one of the following:
  "keywordAndUrlSeed": {
    object (KeywordAndUrlSeed)
  },
  "keywordSeed": {
    object (KeywordSeed)
  },
  "urlSeed": {
    object (UrlSeed)
  },
  "siteSeed": {
    object (SiteSeed)
  }
  // End of list of possible types for union field seed.
}
Pola
geoTargetConstants[]

string

Nazwy zasobów lokalizacji, na którą chcesz kierować reklamy. Maksymalna wartość to 10. MOGĄ używać pustej listy do określenia wszystkich docelowych lokalizacji geograficznych.
includeAdultKeywords

boolean

Jeśli ma wartość true (prawda), odpowiedź będzie zawierać słowa kluczowe związane z treściami dla dorosłych. Wartość domyślna to false (fałsz).
pageToken

string

Token strony do pobrania. Jeśli nie podasz tych danych, zwracana jest pierwsza strona wyników. Aby zażądać następnej strony wyników, użyj wartości uzyskanej z funkcji nextPageToken w poprzedniej odpowiedzi. Pola żądania muszą być takie same na wszystkich stronach.
pageSize

integer

Liczba wyników do pobrania na jednej stronie. Maksymalnie można zwrócić 10 000 wyników. Jeśli parametr pageSize przekroczy ten limit, będzie on ignorowany. Jeśli wartość nie zostanie określona, zwróconych zostanie maksymalnie 10 000 wyników. Serwer może zdecydować się na dalsze ograniczenie liczby zwracanych zasobów. Jeśli odpowiedź zawiera mniej niż 10 000 wyników,nie zostanie ona uznana za ostatnią stronę wyników.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Kierowanie na sieć. Jeśli zasada nie jest skonfigurowana, używana jest sieć wyszukiwania i partnerów Google.
keywordAnnotation[]

enum (KeywordPlanKeywordAnnotation)

Adnotacje ze słowami kluczowymi, które mają być uwzględniane w odpowiedzi.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

Pola zbiorcze, które mają zostać uwzględnione w odpowiedzi.
historicalMetricsOptions

object (HistoricalMetricsOptions)

Opcje danych historycznych.
language

string

Nazwa zasobu języka, na który chcesz kierować reklamy. Każde słowo kluczowe należy do pewnego zestawu języków. Słowo kluczowe jest uwzględniane, jeśli język jest jednym z jego języków. Jeśli zasada nie jest skonfigurowana, uwzględniane będą wszystkie słowa kluczowe.
Pole sumy seed. Rodzaj ziarna, który służy do generowania propozycji słów kluczowych. seed może mieć tylko jedną z tych wartości:
keywordAndUrlSeed

object (KeywordAndUrlSeed)

Słowo kluczowe i konkretny adres URL, na podstawie którego będą generowane propozycje np. samochody, www.example.com/samochody.
keywordSeed

object (KeywordSeed)

Słowo kluczowe lub wyrażenie, na podstawie którego będą generowane pomysły, np. samochody.
urlSeed

object (UrlSeed)

Konkretny adres URL, na podstawie którego będą generowane pomysły, np. www.example.com/samochody.
siteSeed

object (SiteSeed)

Witryna, z której będą generowane pomysły, np. www.example.com.

Treść odpowiedzi

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

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

Zapis JSON 
{
  "results": [
    {
      object (GenerateKeywordIdeaResult)
    }
  ],
  "aggregateMetricResults": {
    object (KeywordPlanAggregateMetricResults)
  },
  "nextPageToken": string,
  "totalSize": string
}
Pola
results[]

object (GenerateKeywordIdeaResult)

Wyniki generowania propozycji słów kluczowych.
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

Zbiorcze dane dotyczące wszystkich propozycji słów kluczowych.
nextPageToken

string

Token podziału na strony używany do pobierania następnej strony wyników. Przekaż zawartość tego ciągu jako atrybut pageToken w następnym żądaniu. nextPageToken nie jest zwracany w przypadku ostatniej strony.
totalSize

string (int64 format)

Łączna liczba dostępnych wyników.

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.

KeywordPlanKeywordAnnotation

Zawiera adnotacje planu słów kluczowych, których można zażądać.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN W tej wersji wartość jest nieznana.
KEYWORD_CONCEPT Zwraca dane dotyczące koncepcji i grupy pojęć słów kluczowych.

KeywordAndUrlSeed

Treść słowa kluczowego i adresu URL

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

string

Wymaga co najmniej jednego słowa kluczowego.
url

string

Adres URL do zindeksowania w celu wygenerowania propozycji słów kluczowych.

KeywordSeed

Treść słowa kluczowego

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

string

Wymaga co najmniej jednego słowa kluczowego.

UrlSeed

Źródło adresu URL

Zapis JSON 
{
  "url": string
}
Pola
url

string

Adres URL do zindeksowania w celu wygenerowania propozycji słów kluczowych.

SiteSeed

Treść witryny

Zapis JSON 
{
  "site": string
}
Pola
site

string

Nazwa domeny witryny. Jeśli klient, który prosi o propozycje, nie jest właścicielem witryny, pod warunkiem, że zwracane są tylko informacje publiczne.

GenerateKeywordIdeaResult

Wynik generowania propozycji słów kluczowych.

Zapis JSON 
{
  "keywordIdeaMetrics": {
    object (KeywordPlanHistoricalMetrics)
  },
  "keywordAnnotations": {
    object (KeywordAnnotations)
  },
  "closeVariants": [
    string
  ],
  "text": string
}
Pola
keywordIdeaMetrics

object (KeywordPlanHistoricalMetrics)

Dane historyczne słowa kluczowego.
keywordAnnotations

object (KeywordAnnotations)

Adnotacje do słowa kluczowego. Dane adnotacji są udostępniane tylko na żądanie.
closeVariants[]

string

Lista zbliżonych odmian żądanych słów kluczowych połączonych w wynik generateKeywordIdeaResult. Definicję „zbliżonych odmian” znajdziesz na https://support.google.com/google-ads/answer/9342105.
text

string

Tekst propozycji słowa kluczowego. Tak jak w przypadku danych historycznych planu słów kluczowych, tekst ten może nie być słowem kluczowym, ale kanoniczną postacią wielu słów kluczowych. Wyświetl komunikat KeywordPlanKeywordHistoryMetrics w usłudze KeywordPlanService.

KeywordAnnotations

Adnotacje do słów kluczowych planu słów kluczowych.

Zapis JSON 
{
  "concepts": [
    {
      object (KeywordConcept)
    }
  ]
}
Pola
concepts[]

object (KeywordConcept)

Lista pojęć związanych ze słowem kluczowym.

KeywordConcept

Pojęcie słowa kluczowego.

Zapis JSON 
{
  "name": string,
  "conceptGroup": {
    object (ConceptGroup)
  }
}
Pola
name

string

Nazwa pojęcia dla słowa kluczowego w grupie pojęć.
conceptGroup

object (ConceptGroup)

Grupa koncepcyjna szczegółów koncepcji.

ConceptGroup

Grupa koncepcyjna pojęcia słowa kluczowego.

Zapis JSON 
{
  "name": string,
  "type": enum (KeywordPlanConceptGroupType)
}
Pola
name

string

Nazwa grupy koncepcji.
type

enum (KeywordPlanConceptGroupType)

Typ grupy koncepcji.

KeywordPlanConceptGroupType

Wylicza typy grup koncepcji planu słów kluczowych.

Wartości w polu enum
UNSPECIFIED Klasyfikacja grupy koncepcji różni się od klasyfikacji marki/niemarkowej. Jest to zasobnik typu catch-all dla wszystkich klasyfikacji, które nie są wymienione poniżej.
UNKNOWN W tej wersji wartość jest nieznana.
BRAND Klasyfikacja grupy koncepcji bazuje na BRAND.
OTHER_BRANDS Klasyfikacja grupy koncepcji na podstawie BRAND, która nie pasowała do klasyfikacji BRAND. Są to zazwyczaj wartości odstające i w tego typu klasyfikacji mogą mieć bardzo mało słów kluczowych.
NON_BRAND Klasyfikacja tej grupy koncepcji nie jest oparta na marce. Ta wartość jest zwracana w przypadku ogólnych słów kluczowych, które nie są związane z marką.