Method: customers.generateKeywordHistoricalMetrics

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

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

Yêu cầu HTTP

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

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 
{
  "keywords": [
    string
  ],
  "includeAdultKeywords": boolean,
  "geoTargetConstants": [
    string
  ],
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "aggregateMetrics": {
    object (KeywordPlanAggregateMetrics)
  },
  "historicalMetricsOptions": {
    object (HistoricalMetricsOptions)
  },
  "language": string
}
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ỏ trùng lặp gần chính xác. Ví dụ: nếu số liệu thống kê cho "xe ô tô" và "xe ô tô" được yêu cầu 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 trong phản hồi. Giá trị mặc định là false.
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.
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.
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á.

Nội dung phản hồi

Tin nhắn phản hồ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)
  }
}
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)

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ả của việc tạo các 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
}
Trường
closeVariants[]

string

Danh sách các biến thể gần giống của những từ khoá được yêu cầu có số liệu thống kê được kết hợp thành GenerateKeywordDataMetricsResult 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á. 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 ban đầu yêu cầu của bạn chứa các từ khoá "xe ô tô" và "xe ô tô", thì cụm từ tìm kiếm trả về sẽ chỉ chứa từ "xe ô tô". Danh sách truy vấn đã loại bỏ trùng lặp sẽ được đưa vào trường CloseVariants.