Method: customers.generateKeywordIdeas

Zwraca listę propozycji słów kluczowych.

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

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

Identyfikator klienta, dla którego jest przeznaczona rekomendacja.

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 docelowej. Maksymalna wartość to 10. Pustą listę można użyć do określenia wszystkich kierowań geograficznych.
includeAdultKeywords

boolean

Jeśli wartość to Prawda, w odpowiedzi będą uwzględniane słowa kluczowe dla dorosłych. Wartość domyślna to false (fałsz).
pageToken

string

Token strony do pobrania. Jeśli nie określono tego ustawienia, zostanie zwrócona pierwsza strona wyników. Aby zażądać następnej strony wyników, użyj wartości uzyskanej z 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że zostać zwróconych 10 000 wyników. Jeśli parametr pageSize przekracza ten limit, jest on ignorowany. Jeśli nie podasz tej wartości, zwrócimy maksymalnie 10 tys. wyników. Serwer może zdecydować o dalszym ograniczeniu liczby zwracanych zasobów. Jeśli odpowiedź zawiera mniej niż 10 000 wyników,może nie zostać uznana za ostatnią stronę wyników.
keywordPlanNetwork

enum (KeywordPlanNetwork)

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

enum (KeywordPlanKeywordAnnotation)

adnotacje słów kluczowych do uwzględnienia w odpowiedzi.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

Pola agregacji do uwzględnienia w odpowiedzi.
historicalMetricsOptions

object (HistoricalMetricsOptions)

Opcje danych historycznych.
language

string

Nazwa zasobu języka docelowego. Każde słowo kluczowe należy do pewnego zbioru języków; słowo kluczowe jest uwzględniane, jeśli język jest jednym z tych języków. Jeśli nie podasz tej wartości, zostaną uwzględnione wszystkie słowa kluczowe.
Pole sumy seed. Rodzaj materiału wyjściowego służącego do generowania propozycji słów kluczowych. seed może być tylko jednym z tych elementów:
keywordAndUrlSeed

object (KeywordAndUrlSeed)

Słowo kluczowe i konkretny URL, aby wygenerować propozycje na podstawie np. samochody, www.example.com/samochody.
keywordSeed

object (KeywordSeed)

Słowo kluczowe lub wyrażenie, na podstawie którego chcesz wygenerować propozycje, np. „samochody”.
urlSeed

object (UrlSeed)

Konkretny URL do wygenerowania propozycji, np. www.example.com/samochody.
siteSeed

object (SiteSeed)

Witryna, z której chcesz czerpać pomysły, np. www.example.com.

Treść odpowiedzi

Wiadomość z odpowiedzią dotyczącą 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 wygenerowania propozycji słów kluczowych.
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

Dane zbiorcze 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 znaków jako atrybut pageToken następnego żądania. Na ostatniej stronie nie jest zwracana wartość nextPageToken.
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

Wylicza adnotacje planu słów kluczowych, o które można poprosić.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Wartość jest nieznana w tej wersji.
KEYWORD_CONCEPT Zwraca dane o koncepcji słowa kluczowego i grupie pojęć.

KeywordAndUrlSeed

Słowo kluczowe i URL wyjściowy

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

string

Wymaga co najmniej jednego słowa kluczowego.
url

string

Adres URL, który ma być zindeksowany w celu wygenerowania propozycji słów kluczowych.

KeywordSeed

Słowa kluczowe z wyjściowego seedu

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

string

Wymaga co najmniej jednego słowa kluczowego.

UrlSeed

URL początkowy

Zapis JSON 
{
  "url": string
}
Pola
url

string

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

SiteSeed

Materiał wyjściowy witryny

Zapis JSON 
{
  "site": string
}
Pola
site

string

Nazwa domeny witryny. Jeśli klient, który prosi o pomysły, nie jest właścicielem witryny, zwracane są tylko informacje publiczne.

GenerateKeywordIdeaResult

Wynik wygenerowania propozycji słów kluczowych.

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

object (KeywordPlanHistoricalMetrics)

Dane historyczne dotyczące słowa kluczowego.
keywordAnnotations

object (KeywordAnnotations)

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

string

Lista zbliżonych odmian żądanych słów kluczowych, które są łączone w tym elemencie GenerateKeywordIdeaResult. Definicję „wariantów podobnych” znajdziesz na stronie https://support.google.com/google-ads/answer/9342105.
text

string

Tekst propozycji słowa kluczowego. Podobnie jak w przypadku danych historycznych planu słów kluczowych, ten tekst może nie być rzeczywistym słowem kluczowym, ale kanoniczną formą wielu słów kluczowych. Zobacz komunikat KeywordPlanKeywordHistoricalMetrics w usłudze KeywordPlanService.

KeywordAnnotations

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

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

object (KeywordConcept)

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

KeywordConcept

Koncepcja słowa kluczowego.

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

string

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

object (ConceptGroup)

Grupa koncepcji szczegółów koncepcji.

ConceptGroup

Grupa pomysłów dla koncepcji słowa kluczowego.

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

string

Nazwa grupy pojęć.
type

enum (KeywordPlanConceptGroupType)

Typ grupy pojęć.

KeywordPlanConceptGroupType

Wylicza typy grup pomysłów w planie słów kluczowych.

Wartości w polu enum
UNSPECIFIED Klasyfikacja grupy koncepcji inna niż marka/niemarka. Jest to zasobnik dla wszystkich klasyfikacji, które nie należą do żadnej z poniższych.
UNKNOWN Wartość jest nieznana w tej wersji.
BRAND Klasyfikacja grupy koncepcji opiera się na BRAND.
OTHER_BRANDS Klasyfikacja grupy konceptów na podstawie atrybutu BRAND, która nie pasuje do klasyfikacji BRAND. Są to zwykle wartości odstające, które mogą mieć bardzo mało słów kluczowych w ramach tego typu klasyfikacji.
NON_BRAND Klasyfikacja grup koncepcji nie jest oparta na słowie kluczowym BRAND. Ten wynik jest zwracany w przypadku ogólnych słów kluczowych, które nie są powiązane z marką.