Method: customers.reports.countInstalledApps

Tạo báo cáo về lượt cài đặt ứng dụng.

Yêu cầu HTTP

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countInstalledApps

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

Tham số đường dẫn

Thông số
customer

string

Bắt buộc. Mã khách hàng hoặc "my_customer" để sử dụng khách hàng được liên kết với tài khoản đưa ra yêu cầu.

Tham số truy vấn

Thông số
orgUnitId

string

Mã đơn vị tổ chức.
pageSize

integer

Số kết quả tối đa cần trả về. Tối đa và mặc định là 100.
pageToken

string

Mã thông báo để chỉ định trang của yêu cầu sẽ được trả về.
filter

string

Chuỗi truy vấn để lọc kết quả, các trường được phân tách bằng AND trong cú pháp EBNF.

Lưu ý: Toán tử OR không được hỗ trợ trong bộ lọc này.

Các trường bộ lọc được hỗ trợ:

  • app_name
  • appType
  • install_type
  • number_of_permissions
  • total_install_count
  • latest_profile_active_date
  • permission_name
  • appId
orderBy

string

Trường được dùng để sắp xếp kết quả.

Thứ tự được hỗ trợ theo trường:

  • app_name
  • appType
  • install_type
  • number_of_permissions
  • total_install_count
  • appId

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

Phản hồi chứa thông tin chi tiết về các ứng dụng đã cài đặt được truy vấn.

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

object (InstalledApp)

Danh sách ứng dụng đã cài đặt khớp với yêu cầu.
nextPageToken

string

Mã thông báo để chỉ định trang tiếp theo của yêu cầu.
totalSize

integer

Tổng số ứng dụng đã cài đặt phù hợp với yêu cầu.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/chrome.management.reports.readonly

InstalledApp

Mô tả một ứng dụng đã cài đặt.

Biểu diễn dưới dạng JSON 
{
  "appId": string,
  "appType": enum (AppType),
  "browserDeviceCount": string,
  "osUserCount": string,
  "appInstallType": enum (AppInstallType),
  "disabled": boolean,
  "appSource": enum (AppSource),
  "displayName": string,
  "description": string,
  "homepageUri": string,
  "permissions": [
    string
  ]
}
Trường
appId

string

Chỉ có đầu ra. Giá trị nhận dạng duy nhất của ứng dụng. Đối với các ứng dụng và tiện ích của Chrome, mã nhận dạng gồm 32 ký tự (ví dụ: ehoadneljpdggcbbknedodolkkjodefl). Đối với ứng dụng Android, tên gói (ví dụ: com.evernote).
appType

enum (AppType)

Chỉ có đầu ra. Loại ứng dụng.
browserDeviceCount

string (int64 format)

Chỉ có đầu ra. Số lượng thiết bị trình duyệt đã cài đặt ứng dụng này.
osUserCount

string (int64 format)

Chỉ có đầu ra. Số người dùng ChromeOS đã cài đặt ứng dụng này.
appInstallType

enum (AppInstallType)

Chỉ có đầu ra. Cách cài đặt ứng dụng.
disabled

boolean

Chỉ có đầu ra. Liệu ứng dụng có bị tắt hay không.
appSource

enum (AppSource)

Chỉ có đầu ra. Nguồn của ứng dụng đã cài đặt.
displayName

string

Chỉ có đầu ra. Tên của ứng dụng đã cài đặt.
description

string

Chỉ có đầu ra. Nội dung mô tả về ứng dụng đã cài đặt.
homepageUri

string

Chỉ có đầu ra. URI trang chủ của ứng dụng đã cài đặt.
permissions[]

string

Chỉ có đầu ra. Quyền của ứng dụng đã cài đặt.

AppInstallType

Cách cài đặt ứng dụng. Nếu không phải mọi phiên bản của ứng dụng đã cài đặt này đều có cùng một loại cài đặt, thì loại cài đặt sẽ là MULTIPLE.

Enum
APP_INSTALL_TYPE_UNSPECIFIED Chưa chỉ định loại cài đặt ứng dụng.
MULTIPLE Nhiều kiểu cài đặt ứng dụng.
NORMAL Hình thức cài đặt ứng dụng thông thường.
ADMIN Loại cài đặt ứng dụng dành cho quản trị viên.
DEVELOPMENT Loại cài đặt ứng dụng trong quá trình phát triển.
SIDELOAD Kiểu cài đặt ứng dụng được cài đặt không qua cửa hàng ứng dụng.
OTHER Loại cài đặt ứng dụng khác.

AppSource

Nguồn của ứng dụng đã cài đặt.

Enum
APP_SOURCE_UNSPECIFIED Chưa chỉ định nguồn ứng dụng.
CHROME_WEBSTORE Nói chung đối với tiện ích và ứng dụng Chrome.
PLAY_STORE Ứng dụng Cửa hàng Play.