Method: customers.generateKeywordHistoricalMetrics

Trả về danh sách các chỉ số trước đây của từ khoá.

Danh sách lỗi được tạo ra: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

Yêu cầu HTTP

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

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 
{
  "keywords": [
    string
  ],
  "includeAdultKeywords": boolean,
  "geoTargetConstants": [
    string
  ],
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "aggregateMetrics": {
    object (KeywordPlanAggregateMetrics)
  },
  "historicalMetricsOptions": {
    object (HistoricalMetricsOptions)
  },
  "language": string
}
Các trường
keywords[]

string

Danh sách từ khoá để xem các chỉ số trước đây. Không phải tất cả dữ liệu đầu vào đều được trả về do việc loại bỏ gần như chính xác. Ví dụ: nếu có yêu cầu thống kê cho "xe ô tô" và "xe ô tô", thì chỉ có "xe ô tô" được trả về. Bạn có thể sử dụng tối đa 10.000 từ khoá.
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.
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.
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.
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.

Nội dung phản hồi

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

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 (GenerateKeywordHistoricalMetricsResult)
    }
  ],
  "aggregateMetricResults": {
    object (KeywordPlanAggregateMetricResults)
  }
}
Các trường
results[]

object (GenerateKeywordHistoricalMetricsResult)

Danh sách từ khoá và các chỉ số trước đây của từ khoá.
aggregateMetricResults

object (KeywordPlanAggregateMetricResults)

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

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.

GenerateKeywordHistoricalMetricsResult

Kết quả tạo chỉ số trước đây của từ khoá.

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

string

Danh sách các biến thể gần giống của các từ khoá yêu cầu có số liệu thống kê được kết hợp vào GenerateKeywordẻMetricsResult này.
keywordMetrics

object (KeywordPlanHistoricalMetrics)

Các chỉ số trước đây cho văn bản và các biến thể gần giống của văn bản
text

string

Văn bản của cụm từ tìm kiếm được liên kết với một hoặc nhiều từ khoá. Xin lưu ý rằng chúng tôi loại bỏ danh sách từ khoá trùng lặp, loại bỏ các biến thể gần giống trước khi trả lại từ khoá dưới dạng văn bản. Ví dụ: nếu yêu cầu của bạn ban đầu chứa từ khoá "xe ô tô" và "xe ô tô", thì cụm từ tìm kiếm được trả về sẽ chỉ chứa từ "xe ô tô". Danh sách các truy vấn đã loại bỏ trùng lặp sẽ được đưa vào trường closeVariants.