Method: customers.generateKeywordIdeas

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

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

Yêu cầu HTTP

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

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

Tham số đường dẫn

Tham số
customerId

string

Mã của khách hàng có nội dung đề 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.
}
Trường
geoTargetConstants[]

string

Tên tài nguyên của vị trí để nhắm mục tiêu. Tối đa là 10. CÓ THỂ sử dụng danh sách trống để chỉ định tất cả cá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 trong 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ị nhận đượ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, kết quả sẽ bị bỏ qua. Nếu không chỉ định, 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 phản hồi chứa ít hơn 10.000 kết quả thì có thể trang đó không được coi là trang kết quả cuối cùng.
keywordPlanNetwork

enum (KeywordPlanNetwork)

Nhắm mục tiêu mạng. Nếu không được đặt, 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 trong 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ố trước đây.
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 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 nhóm ngôn ngữ đó. Nếu bạn không đặt chính sách này, thì hệ thống sẽ bao gồm tất cả từ khoá.
Trường hợp 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:
keywordAndUrlSeed

object (KeywordAndUrlSeed)

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

object (KeywordSeed)

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

object (UrlSeed)

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

object (SiteSeed)

Trang web để tạo ý tưởng, chẳng hạn như www.example.com.

Nội dung phản hồi

Tin nhắn phản hồ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
}
Trường
results[]

object (GenerateKeywordIdeaResult)

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

object (KeywordPlanAggregateMetricResults)

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

string

Mã thông báo phân trang được 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á có thể được yêu cầu.

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

KeywordAndUrlSeed

Nguồn gốc từ khóa và URL

Biểu diễn dưới dạng JSON 
{
  "keywords": [
    string
  ],
  "url": string
}
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 các ý tưởng từ khoá.

KeywordSeed

Nguồn gốc từ khóa

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

string

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

UrlSeed

Nội dung gốc của URL

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

string

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

SiteSeed

Nguồn gốc trang web

Biểu diễn dưới dạng JSON 
{
  "site": string
}
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ả về 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
}
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ừ khóa yêu cầu được kết hợp thành GenerateKeywordIdeaResult này. Hãy xem https://support.google.com/google-ads/answer/9342105 để biết đị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à từ khoá thực sự, mà là dạng chính tắc của nhiều từ khoá. Xem thông báo KeywordPlanKeywordDataMetrics trong KeywordPlanService.

KeywordAnnotations

Chú thích cho từ khoá trong kế hoạch từ khoá.

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

object (KeywordConcept)

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

KeywordConcept

Khái niệm cho từ khoá.

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

string

Tên khái niệm cho từ khoá trong nhóm ý tưởng.
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)
}
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 phải 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 sách nào bên dưới.
UNKNOWN Giá trị không xác định trong phiên bản này.
BRAND Phân loại nhóm khái niệm dựa trên BRAND.
OTHER_BRANDS Việc 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à các trường hợp ngoại lệ và có thể có rất ít từ khoá trong kiểu 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. Cụm từ 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.