Method: customers.generateKeywordIdeas

Trả về danh sách các ý tưởng từ khoá.

Danh sách các lỗi được gửi: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError KeywordPlanIdeaError QuotaError RequestError

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Các tham số
customerId

string

Mã khách hàng có đề xuất.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng 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.
}
Các trường
geoTargetConstants[]

string

Tên tài nguyên của vị trí cần nhắm mục tiêu. Tối đa là 10. Bạn CÓ THỂ sử dụng danh sách trống để chỉ định tất cả vị trí địa lý nhắm mục tiêu.
includeAdultKeywords

boolean

Nếu đúng, các từ khoá người lớn sẽ được đưa vào phản hồi. Giá trị mặc định là false.
pageToken

string

Mã thông báo của trang cần truy xuất. Nếu không được chỉ định, hệ thống sẽ trả về trang kết quả đầu tiên. Để yêu cầu trang kết quả tiếp theo, hãy sử dụng giá trị thu được từ nextPageToken trong phản hồi trước. Các trường yêu cầu phải khớp nhau trên các trang.
pageSize

integer

Số lượng kết quả cần truy xuất trong một trang. Tối đa 10.000 kết quả có thể được trả về. Nếu pageSize vượt quá giới hạn này, thì kết quả đó sẽ bị bỏ qua. Nếu bạn không chỉ định thì hệ thống sẽ trả về tối đa 10.000 kết quả. Máy chủ có thể quyết định giới hạn thêm số lượng tài nguyên được trả về. Nếu câu trả lời chứa ít hơn 10.000 kết quả thì có thể không được coi là trang kết quả cuối cùng.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Mạng nhắm mục tiêu. Nếu bạn không đặt chính sách này, Mạng Tìm kiếm và đối tác của Google sẽ được sử dụng.
keywordAnnotation[]

enum (KeywordPlanKeywordAnnotation)

Các chú thích từ khoá cần đưa vào phản hồi.
aggregateMetrics

object (KeywordPlanAggregateMetrics)

Các trường tổng hợp để đưa vào phản hồi.
historicalMetricsOptions

object (HistoricalMetricsOptions)

Các lựa chọn về dữ liệu chỉ số trong quá khứ.
language

string

Tên tài nguyên của ngôn ngữ cần nhắm mục tiêu. Mỗi từ khoá thuộc về một số nhóm ngôn ngữ; một từ khoá sẽ được đưa vào nếu ngôn ngữ là một trong các ngôn ngữ của từ khoá đó. Nếu bạn không đặt chính sách này, thì tất cả từ khoá sẽ được đưa vào.
Trường nhóm seed. Loại nội dung gốc để tạo ý tưởng từ khoá. seed chỉ có thể là một trong những trạng thái sau đây:
keywordAndUrlSeed

object (KeywordAndUrlSeed)

Từ khoá và một URL cụ thể để tạo ý tưởng, ví dụ như ô tô, www.example.com/cars.
keywordSeed

object (KeywordSeed)

Từ khoá hoặc cụm từ để tạo ý tưởng, ví dụ: ô tô.
urlSeed

object (UrlSeed)

URL cụ thể để tạo ý tưởng, ví dụ: www.example.com/cars.
siteSeed

object (SiteSeed)

Trang web để tạo ý tưởng, ví dụ: www.example.com.

Nội dung phản hồi

Tin nhắn trả lời cho KeywordPlanIdeaService.GenerateKeywordIdeas.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "results": [
    {
      object (GenerateKeywordIdeaResult)
    }
  ],
  "aggregateMetricResults": {
    object (KeywordPlanAggregateMetricResults)
  },
  "nextPageToken": string,
  "totalSize": string
}
Các trường
results[]

object (GenerateKeywordIdeaResult)

Kết quả tạo ý tưởng từ khoá.
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

Các chỉ số tổng hợp cho tất cả ý tưởng từ khoá.
nextPageToken

string

Mã thông báo phân trang dùng để truy xuất trang kết quả tiếp theo. Truyền nội dung của chuỗi này dưới dạng thuộc tính pageToken của yêu cầu tiếp theo. nextPageToken không được trả về cho trang cuối cùng.
totalSize

string (int64 format)

Tổng số kết quả có sẵn.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/adwords

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.

KeywordPlanKeywordAnnotation

Liệt kê các chú thích kế hoạch từ khoá mà hệ thống có thể yêu cầu.

Enum
UNSPECIFIED Chưa xác định.
UNKNOWN Phiên bản này không xác định được giá trị.
KEYWORD_CONCEPT Trả về dữ liệu về khái niệm từ khoá và nhóm khái niệm.

KeywordAndUrlSeed

Từ khóa và URL gốc

Biểu diễn dưới dạng JSON 
{
  "keywords": [
    string
  ],
  "url": string
}
Các trường
keywords[]

string

Yêu cầu ít nhất một từ khóa.
url

string

URL cần thu thập thông tin để tạo ý tưởng từ khoá.

KeywordSeed

Từ khóa gốc

Biểu diễn dưới dạng JSON 
{
  "keywords": [
    string
  ]
}
Các trường
keywords[]

string

Yêu cầu ít nhất một từ khóa.

UrlSeed

Nội dung gốc URL

Biểu diễn dưới dạng JSON 
{
  "url": string
}
Các trường
url

string

URL cần thu thập thông tin để tạo ý tưởng từ khoá.

SiteSeed

Nội dung gốc của trang web

Biểu diễn dưới dạng JSON 
{
  "site": string
}
Các trường
site

string

Tên miền của trang web. Nếu khách hàng yêu cầu ý tưởng không sở hữu trang web đã cung cấp, hệ thống sẽ chỉ trả lại thông tin công khai.

GenerateKeywordIdeaResult

Kết quả của việc tạo ý tưởng từ khoá.

Biểu diễn dưới dạng JSON 
{
  "keywordIdeaMetrics": {
    object (KeywordPlanHistoricalMetrics)
  },
  "keywordAnnotations": {
    object (KeywordAnnotations)
  },
  "closeVariants": [
    string
  ],
  "text": string
}
Các trường
keywordIdeaMetrics

object (KeywordPlanHistoricalMetrics)

Các chỉ số trước đây cho từ khoá.
keywordAnnotations

object (KeywordAnnotations)

Các chú thích cho từ khoá. Dữ liệu chú thích chỉ được cung cấp khi có yêu cầu.
closeVariants[]

string

Danh sách các biến thể gần giống của các từ khoá yêu cầu mà được kết hợp vào GenerateKeywordIdeaResult này. Hãy truy cập vào https://support.google.com/google-ads/answer/9342105 để xem định nghĩa về "biến thể gần giống".
text

string

Văn bản của ý tưởng từ khoá. Như trong các chỉ số trước đây của Kế hoạch từ khoá, văn bản này có thể không phải là một từ khoá thực sự, mà là dạng chuẩn của nhiều từ khoá. Xem thông báo KeywordPlanKeywordKeywordMetrics trong KeywordPlanService.

KeywordAnnotations

Các chú thích cho từ khoá của kế hoạch từ khoá.

Biểu diễn dưới dạng JSON 
{
  "concepts": [
    {
      object (KeywordConcept)
    }
  ]
}
Các trường
concepts[]

object (KeywordConcept)

Danh sách khái niệm cho từ khoá.

KeywordConcept

Ý tưởng cho từ khoá.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "conceptGroup": {
    object (ConceptGroup)
  }
}
Các trường
name

string

Tên khái niệm cho từ khoá trong thuộc ý tưởngGroup.
conceptGroup

object (ConceptGroup)

Nhóm khái niệm của thông tin chi tiết về khái niệm.

ConceptGroup

Nhóm khái niệm cho khái niệm từ khoá.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "type": enum (KeywordPlanConceptGroupType)
}
Các trường
name

string

Tên nhóm khái niệm.
type

enum (KeywordPlanConceptGroupType)

Loại nhóm khái niệm.

KeywordPlanConceptGroupType

Liệt kê các loại nhóm khái niệm của kế hoạch từ khoá.

Enum
UNSPECIFIED Cách phân loại nhóm khái niệm khác với thương hiệu/không có thương hiệu. Đây là bộ chứa tổng hợp cho tất cả các phân loại không thuộc danh mục nào bên dưới.
UNKNOWN Phiên bản này không xác định được giá trị.
BRAND Việc phân loại nhóm khái niệm dựa trên BRAND.
OTHER_BRANDS Cách phân loại nhóm khái niệm dựa trên BRAND không phù hợp với cách phân loại BRAND. Đây thường là những điểm ngoại lai và có thể có rất ít từ khoá trong loại phân loại này.
NON_BRAND Việc phân loại nhóm khái niệm này không dựa trên BRAND. Thuộc tính này được trả về cho các từ khoá chung chung không có mối liên kết với thương hiệu.