- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- KeywordPlanKeywordAnnotation
- KeywordAndUrlSeed
- KeywordSeed
- UrlSeed
- SiteSeed
- GenerateKeywordIdeaResult
- KeywordAnnotations
- KeywordConcept
- ConceptGroup
- KeywordPlanConceptGroupType
- Wypróbuj
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/v15/customers/{customerId}:generateKeywordIdeas
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
customerId |
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 ( |
Pola | |
---|---|
geoTargetConstants[] |
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 |
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 |
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 |
pageSize |
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 |
Kierowanie na sieć. Jeśli zasada nie jest skonfigurowana, używana jest sieć wyszukiwania i partnerów Google. |
keywordAnnotation[] |
Adnotacje ze słowami kluczowymi, które mają być uwzględniane w odpowiedzi. |
aggregateMetrics |
Pola zbiorcze, które mają zostać uwzględnione w odpowiedzi. |
historicalMetricsOptions |
Opcje danych historycznych. |
language |
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 |
Słowo kluczowe i konkretny adres URL, na podstawie którego będą generowane propozycje np. samochody, www.example.com/samochody. |
keywordSeed |
Słowo kluczowe lub wyrażenie, na podstawie którego będą generowane pomysły, np. samochody. |
urlSeed |
Konkretny adres URL, na podstawie którego będą generowane pomysły, np. www.example.com/samochody. |
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 ( |
Pola | |
---|---|
results[] |
Wyniki generowania propozycji słów kluczowych. |
aggregateMetricResults |
Zbiorcze dane dotyczące wszystkich propozycji słów kluczowych. |
nextPageToken |
Token podziału na strony używany do pobierania następnej strony wyników. Przekaż zawartość tego ciągu jako atrybut |
totalSize |
Łą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[] |
Wymaga co najmniej jednego słowa kluczowego. |
url |
Adres URL do zindeksowania w celu wygenerowania propozycji słów kluczowych. |
KeywordSeed
Treść słowa kluczowego
Zapis JSON |
---|
{ "keywords": [ string ] } |
Pola | |
---|---|
keywords[] |
Wymaga co najmniej jednego słowa kluczowego. |
UrlSeed
Źródło adresu URL
Zapis JSON |
---|
{ "url": string } |
Pola | |
---|---|
url |
Adres URL do zindeksowania w celu wygenerowania propozycji słów kluczowych. |
SiteSeed
Treść witryny
Zapis JSON |
---|
{ "site": string } |
Pola | |
---|---|
site |
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 ( |
Pola | |
---|---|
keywordIdeaMetrics |
Dane historyczne słowa kluczowego. |
keywordAnnotations |
Adnotacje do słowa kluczowego. Dane adnotacji są udostępniane tylko na żądanie. |
closeVariants[] |
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 |
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 ( |
Pola | |
---|---|
concepts[] |
Lista pojęć związanych ze słowem kluczowym. |
KeywordConcept
Pojęcie słowa kluczowego.
Zapis JSON |
---|
{
"name": string,
"conceptGroup": {
object ( |
Pola | |
---|---|
name |
Nazwa pojęcia dla słowa kluczowego w grupie pojęć. |
conceptGroup |
Grupa koncepcyjna szczegółów koncepcji. |
ConceptGroup
Grupa koncepcyjna pojęcia słowa kluczowego.
Zapis JSON |
---|
{
"name": string,
"type": enum ( |
Pola | |
---|---|
name |
Nazwa grupy koncepcji. |
type |
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ą. |