Method: publishers.items.queryMetrics

Truy vấn các chỉ số cho một mục.

Yêu cầu HTTP

GET https://chromewebstore.googleapis.com/v2/{name=publishers/*/items/*}:queryMetrics

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

Tham số đường dẫn

Tham số
name

string

Bắt buộc. Tên của mục cần truy vấn chỉ số. Định dạng: publishers/{publisher}/items/{item}

Tham số truy vấn

Tham số
timeSpec

object (TimeSpec)

Bắt buộc. Thông số thời gian để truy vấn tập hợp chỉ số.
metrics[]

string

Bắt buộc. Các chỉ số để truy vấn tập hợp chỉ số.

Các chỉ số được hỗ trợ:

  • installs: Số lượt cài đặt mặt hàng.
  • installs-7d: Số lượt cài đặt mục trong 7 ngày qua.
  • uninstalls: Số lượt gỡ cài đặt mục.
  • users: Số người dùng hoạt động hằng ngày của mặt hàng.
  • users-7d: Số người dùng hoạt động trong 7 ngày của mặt hàng.
  • impressions: Số lượt hiển thị mặt hàng trên toàn bộ trang chủ cửa hàng.
  • page-views: Số lượt xem trang thông tin chi tiết về mặt hàng.
dimensions[]

string

Không bắt buộc. Phương diện để phân chia chỉ số. Bạn chỉ có thể chỉ định tối đa một phương diện.

Các phương diện được hỗ trợ:

  • os: Hệ điều hành của người dùng.
  • app-version: Phiên bản của mặt hàng.
  • country: Quốc gia của người dùng.
  • install-source: Nguồn cài đặt.
  • install-type: Loại cài đặt (từ cửa hàng trực tuyến, tại chỗ hoặc loại khác).
  • language: Ngôn ngữ của người dùng.
  • enabled: Cho biết mục này đang bật hay tắt.
  • utm-campaign: Chiến dịch UTM của người dùng.
  • utm-content: Nội dung UTM của người dùng.
  • utm-medium: Phương tiện UTM của người dùng.
  • utm-source: Nguồn UTM của người dùng.
  • utm-term: Từ khoá UTM của người dùng.
pageSize

integer

Không bắt buộc. Số hàng tối đa cần trả về. Nếu không được chỉ định, hệ thống sẽ trả về tối đa 100 hàng. Giá trị tối đa là 1000; Các giá trị trên 1000 sẽ được chuyển thành 1000.
pageToken

string

Không bắt buộc. Mã thông báo trang, nhận được từ lệnh gọi trước đó. Cung cấp mã này để truy xuất trang tiếp theo.

Khi phân trang, tất cả các tham số khác được cung cấp cho yêu cầu phải khớp với lệnh gọi đã cung cấp mã thông báo trang.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Thông báo phản hồi cho items.queryMetrics.

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 
{
  "metricRows": [
    {
      object (MetricRow)
    }
  ],
  "nextPageToken": string
}
Trường
metricRows[]

object (MetricRow)

Các hàng chỉ số.
nextPageToken

string

Mã thông báo có thể được gửi dưới dạng pageToken để truy xuất trang tiếp theo. Nếu trường này bị bỏ qua, thì sẽ không có trang tiếp theo.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/chromewebstore
  • https://www.googleapis.com/auth/chromewebstore.readonly

TimeSpec

Phạm vi ngày để truy vấn các chỉ số.

Biểu diễn dưới dạng JSON 
{
  "firstDate": {
    object (Date)
  },
  "lastDate": {
    object (Date)
  }
}
Trường
firstDate

object (Date)

Không bắt buộc. Ngày đầu tiên (bao gồm cả ngày này) của thông số thời gian. Nếu bạn không đặt, thì sẽ không có giới hạn dưới nào được áp dụng.
lastDate

object (Date)

Không bắt buộc. Ngày cuối cùng (bao gồm cả ngày này) của thông số thời gian. Nếu bạn không đặt, thì sẽ không có giới hạn trên nào được áp dụng.

Ngày

Biểu thị một ngày dương lịch đầy đủ hoặc một phần, chẳng hạn như ngày sinh. Thời gian trong ngày và múi giờ được chỉ định ở nơi khác hoặc không quan trọng. Ngày này được tính theo Dương lịch. Điều này có thể đại diện cho một trong những trường hợp sau:

  • Ngày đầy đủ, có giá trị năm, tháng và ngày khác 0.
  • Tháng và ngày, với năm bằng 0 (ví dụ: ngày kỷ niệm).
  • Chỉ có năm, tháng và ngày đều là 0.
  • Năm và tháng, với ngày bằng 0 (ví dụ: ngày hết hạn của thẻ tín dụng).

Các loại liên quan:

Biểu diễn dưới dạng JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Trường
year

integer

Năm của ngày. Phải từ 1 đến 9999 hoặc 0 để chỉ định ngày không có năm.
month

integer

Tháng trong năm. Phải từ 1 đến 12 hoặc 0 để chỉ định một năm không có tháng và ngày.
day

integer

Ngày trong tháng. Phải từ 1 đến 31 và hợp lệ cho năm và tháng, hoặc 0 để chỉ định một năm hoặc một năm và tháng mà ngày không quan trọng.

MetricRow

Một hàng gồm các chỉ số và giá trị phương diện.

Biểu diễn dưới dạng JSON 
{
  "date": {
    object (Date)
  },
  "dimensionValues": [
    string
  ],
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
Trường
date

object (Date)

Ngày của bản ghi.
dimensionValues[]

string

Cột giá trị phương diện cho hàng.
metricValues[]

object (MetricValue)

Cột chỉ số cho hàng.

MetricValue

Biểu thị giá trị của một chỉ số

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

string

Tên chỉ số
value

string (int64 format)

Giá trị của chỉ số.
uniqueUserCount

string (int64 format)

Số người dùng riêng biệt liên kết với chỉ số (nếu có).