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/v16/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. MOŻNA użyć pustej listy do określenia wszystkich docelowych lokalizacji geograficznych.
includeAdultKeywords

boolean

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

string

Token strony do pobrania. Jeśli nie podasz żadnej wartości, wyświetlana będzie 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 różnych 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, zostanie zignorowany. Jeśli nie określono inaczej, zwróconych zostanie maksymalnie 10 000 wyników. Serwer może dodatkowo ograniczyć liczbę zwracanych zasobów. Jeśli odpowiedź zawiera mniej niż 10 000 wyników,nie można jej uznać za ostatnią stronę wyników.
keywordPlanNetwork

enum (KeywordPlanNetwork)

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

enum (KeywordPlanKeywordAnnotation)

Adnotacje ze słowami kluczowymi, które mają być uwzględnione 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 są kierowane 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 języków. Jeśli jej nie skonfigurujesz, uwzględnione 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 być tylko jedną z tych wartości:
keywordAndUrlSeed

object (KeywordAndUrlSeed)

Słowo kluczowe i określony adres URL do generowania propozycji, np. samochody, www.example.com/samochody.
keywordSeed

object (KeywordSeed)

Słowo kluczowe lub wyrażenie do generowania propozycji, np. „samochody”.
urlSeed

object (UrlSeed)

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

object (SiteSeed)

Witryna, na której będą generowane propozycje, 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 generowania propozycji słów kluczowych.
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

Dane zbiorcze dla 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. dla ostatniej strony nie zwracany jest 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 omówieniu protokołu OAuth 2.0.

KeywordPlanKeywordAnnotation

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

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

KeywordAndUrlSeed

Element wyjściowy słowa kluczowego i URL-a

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 URL-a

Zapis JSON 
{
  "url": string
}
Pola
url

string

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

SiteSeed

Treść strony

Zapis JSON 
{
  "site": string
}
Pola
site

string

Nazwa domeny witryny. Jeśli klient proszący o propozycje nie jest właścicielem witryny, 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 o słowie kluczowym.
keywordAnnotations

object (KeywordAnnotations)

Adnotacje dotyczące słowa kluczowego. Dane adnotacji są udostępniane tylko wtedy, gdy są wymagane.
closeVariants[]

string

Lista zbliżonych odmian żądanych słów kluczowych, które są połączone w ten sposób GenerateKeywordIdeaResult. Definicję „zbliżonych odmian” 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, tekst ten może nie być rzeczywistym słowem kluczowym, ale kanoniczną postacią wielu słów kluczowych. Wyświetlanie komunikatu 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 związane ze słowem kluczowym.

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

string

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

object (ConceptGroup)

Grupa koncepcji szczegółów koncepcji.

ConceptGroup

Grupa koncepcji 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

Oblicza 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 należą do żadnej z poniższych kategorii.
UNKNOWN Wartość jest nieznana w tej wersji.
BRAND Klasyfikacja grupy koncepcji bazuje na BRAND.
OTHER_BRANDS Klasyfikacja grupy koncepcji na podstawie elementu BRAND, która nie pasuje do klasyfikacji BRAND. Są to na ogół wartości odstające i mogą mieć bardzo niewiele słów kluczowych w tego typu klasyfikacji.
NON_BRAND Ta klasyfikacja grupy koncepcji nie jest oparta na BRAND. Ta wartość jest zwracana w przypadku ogólnych słów kluczowych, które nie są powiązane z marką.