- Yêu cầu HTTP
- Tham số đường dẫn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- KeywordPlanKeywordAnnotation
- KeywordAndUrlSeed
- KeywordSeed
- UrlSeed
- SiteSeed
- GenerateKeywordIdeaResult
- KeywordAnnotations
- KeywordConcept
- ConceptGroup
- KeywordPlanConceptGroupType
- Hãy làm thử!
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 |
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 ( |
Các trường | |
---|---|
geoTargetConstants[] |
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 |
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 |
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ừ |
pageSize |
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 |
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[] |
Các chú thích từ khoá cần đưa vào phản hồi. |
aggregateMetrics |
Các trường tổng hợp để đưa vào phản hồi. |
historicalMetricsOptions |
Các lựa chọn về dữ liệu chỉ số trong quá khứ. |
language |
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 |
Từ khoá và một URL cụ thể để tạo ý tưởng, ví dụ như ô tô, www.example.com/cars. |
keywordSeed |
Từ khoá hoặc cụm từ để tạo ý tưởng, ví dụ: ô tô. |
urlSeed |
URL cụ thể để tạo ý tưởng, ví dụ: www.example.com/cars. |
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 ( |
Các trường | |
---|---|
results[] |
Kết quả tạo ý tưởng từ khoá. |
aggregateMetricResults |
Các chỉ số tổng hợp cho tất cả ý tưởng từ khoá. |
nextPageToken |
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 |
totalSize |
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[] |
Yêu cầu ít nhất một từ khóa. |
url |
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[] |
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 |
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 |
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 ( |
Các trường | |
---|---|
keywordIdeaMetrics |
Các chỉ số trước đây cho từ khoá. |
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[] |
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 |
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 ( |
Các trường | |
---|---|
concepts[] |
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 ( |
Các trường | |
---|---|
name |
Tên khái niệm cho từ khoá trong thuộc ý tưởngGroup. |
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 ( |
Các trường | |
---|---|
name |
Tên nhóm khái niệm. |
type |
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. |