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 liczba 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 zostanie określony, zwrócona zostanie 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. Zwracane jest maksymalnie 10 tys. wyników. Jeśli parametr pageSize przekracza tę wartość, jest 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 tys. wyników, nie można założyć, że jest to ostatnia strona wyników.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Sieć kierowania. Jeśli nie zostanie ustawiona, używana będzie sieć wyszukiwarki Google i 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 dotyczących danych statystycznych.
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 ustawisz tego parametru, zostaną uwzględnione wszystkie słowa kluczowe.
Pole unii seed. Typ danych wyjściowych służących do generowania propozycji słów kluczowych. seed może być tylko jednym z tych elementów:
keywordAndUrlSeed

object (KeywordAndUrlSeed)

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

object (KeywordSeed)

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

object (UrlSeed)

Określony adres URL, z którego mają być generowane pomysły, np. www.example.com/cars.
siteSeed

object (SiteSeed)

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

Treść odpowiedzi

Odpowiedź na pytanie „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 strony służący do pobierania następnej strony wyników. Przekaż zawartość tego ciągu jako atrybut pageToken kolejnego żą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 OAuth 2.0 Overview.

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 koncepcji słowa kluczowego i grupy koncepcji.

KeywordAndUrlSeed

Słowo kluczowe i ziarno URL

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

string

Wymaga co najmniej 1 słowa kluczowego i nie więcej niż 20 słów kluczowych.
url

string

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

KeywordSeed

Słowa kluczowe z wyjściowego zestawu słów kluczowych

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

string

Wymaga co najmniej 1 słowa kluczowego i nie więcej niż 20 słów kluczowych.

UrlSeed

Url Seed

Zapis JSON 
{
  "url": string
}
Pola
url

string

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

SiteSeed

Site Seed

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 dotyczące 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 dotyczących 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 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 koncepcji dla słowa kluczowego w grupie koncepcji.
conceptGroup

object (ConceptGroup)

Grupa pomysłów, której dotyczą szczegóły.

ConceptGroup

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

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

string

Nazwa grupy koncepcji.
type

enum (KeywordPlanConceptGroupType)

Typ grupy pomysłów.

KeywordPlanConceptGroupType

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

Wartości w polu enum
UNSPECIFIED Klasyfikacja grupy koncepcji inna niż marka/niemarka. To ogólne ujęcie wszystkich klasyfikacji, które nie pasują do żadnej z tych poniżej.
UNKNOWN Wartość jest nieznana w tej wersji.
BRAND Klasyfikacja grup koncepcji jest oparta na słowie kluczowym BRAND.
OTHER_BRANDS Klasyfikacja grupy konceptów na podstawie atrybutu BRAND, która nie pasowała 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. Jest on zwracany w przypadku słów kluczowych ogólnych, które nie są powiązane z marką.