- Żą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/v16/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. MOŻNA użyć pustej listy do określenia wszystkich docelowych lokalizacji geograficznych. |
includeAdultKeywords |
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 |
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 |
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, 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 |
Kierowanie na sieć. Jeśli zasada nie jest skonfigurowana, używana będzie sieć wyszukiwania i sieć partnerów Google. |
keywordAnnotation[] |
Adnotacje ze słowami kluczowymi, które mają być uwzględnione 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 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 |
Słowo kluczowe i określony adres URL do generowania propozycji, np. samochody, www.example.com/samochody. |
keywordSeed |
Słowo kluczowe lub wyrażenie do generowania propozycji, np. „samochody”. |
urlSeed |
Konkretny adres URL, na podstawie którego będą generowane propozycje, np. www.example.com/samochody. |
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 ( |
Pola | |
---|---|
results[] |
Wyniki generowania propozycji słów kluczowych. |
aggregateMetricResults |
Dane zbiorcze dla 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 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[] |
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 URL-a
Zapis JSON |
---|
{ "url": string } |
Pola | |
---|---|
url |
Adres URL do zindeksowania w celu wygenerowania propozycji słów kluczowych. |
SiteSeed
Treść strony
Zapis JSON |
---|
{ "site": string } |
Pola | |
---|---|
site |
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 ( |
Pola | |
---|---|
keywordIdeaMetrics |
Dane historyczne o słowie kluczowym. |
keywordAnnotations |
Adnotacje dotyczące słowa kluczowego. Dane adnotacji są udostępniane tylko wtedy, gdy są wymagane. |
closeVariants[] |
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 |
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 ( |
Pola | |
---|---|
concepts[] |
Lista pojęć związanych ze słowem kluczowym. |
KeywordConcept
Pojęcie związane ze słowem kluczowym.
Zapis JSON |
---|
{
"name": string,
"conceptGroup": {
object ( |
Pola | |
---|---|
name |
Nazwa pojęcia słowa kluczowego w grupie koncepcji. |
conceptGroup |
Grupa koncepcji szczegółów koncepcji. |
ConceptGroup
Grupa koncepcji pojęcia słowa kluczowego.
Zapis JSON |
---|
{
"name": string,
"type": enum ( |
Pola | |
---|---|
name |
Nazwa grupy koncepcji. |
type |
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ą. |