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ã nhận dạng của đơn vị tổ chức.
pageSize

integer

Số kết quả tối đa cần trả về. Giá trị 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 cần 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 dấu AND bằng cú pháp EBNF.

Lưu ý: Bộ lọc này không hỗ trợ toán tử HOẶC.

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
  • manifest_versions
  • risk_score
orderBy

string

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

Các trường được hỗ trợ theo thứ tự:

  • app_name
  • appType
  • install_type
  • number_of_permissions
  • total_install_count
  • appId
  • manifest_versions
  • risk_score

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

Nội dung 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 các ứ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 khớ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
  ],
  "riskAssessment": {
    object (RiskAssessmentData)
  }
}
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 ứng dụng và tiện ích 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ố lượng 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 ứng dụng đã cài đặt.
description

string

Chỉ có đầu ra. 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.
riskAssessment

object (RiskAssessmentData)

Chỉ có đầu ra. Dữ liệu đánh giá rủi ro về tiện ích này (nếu có).

AppInstallType

Cách cài đặt ứng dụng. Nếu không phải tất cả các 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 là NHIỀU.

Enum
APP_INSTALL_TYPE_UNSPECIFIED Chưa chỉ định loại cài đặt ứng dụng.
MULTIPLE Nhiều loại cài đặt ứng dụng.
NORMAL Loại cài đặt ứng dụng thông thường.
ADMIN Loại cài đặt ứng dụng quản trị.
DEVELOPMENT Loại cài đặt ứng dụng phát triển.
SIDELOAD Loại cài đặt ứng dụng được tải 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 Thường dành cho các tiện ích và ứng dụng Chrome.
PLAY_STORE Ứng dụng Cửa hàng Play.

RiskAssessmentData

Dữ liệu đánh giá rủi ro của một tiện ích/ứng dụng.

Biểu diễn dưới dạng JSON 
{
  "entries": [
    {
      object (RiskAssessmentEntry)
    }
  ],
  "overallRiskLevel": enum (RiskLevel)
}
Trường
entries[]

object (RiskAssessmentEntry)

Đánh giá rủi ro riêng lẻ.
overallRiskLevel

enum (RiskLevel)

Mức độ rủi ro tổng thể được đánh giá trên tất cả các mục. Đây sẽ là mức rủi ro cao nhất trong tất cả các mục.

RiskAssessmentEntry

Một mục đánh giá rủi ro.

Biểu diễn dưới dạng JSON 
{
  "provider": enum (RiskAssessmentProvider),
  "riskAssessment": {
    object (RiskAssessment)
  },
  "riskLevel": enum (RiskLevel)
}
Trường
provider

enum (RiskAssessmentProvider)

Nhà cung cấp dịch vụ đánh giá rủi ro cho mục nhập này.
riskAssessment

object (RiskAssessment)

Thông tin chi tiết về việc đánh giá rủi ro của nhà cung cấp.
riskLevel

enum (RiskLevel)

Mức độ rủi ro được phân nhóm cho quy trình đánh giá rủi ro.

RiskAssessmentProvider

Nhà cung cấp dịch vụ đánh giá rủi ro.

Enum
RISK_ASSESSMENT_PROVIDER_UNSPECIFIED Giá trị mặc định khi không chỉ định nhà cung cấp.
RISK_ASSESSMENT_PROVIDER_CRXCAVATOR CRXcavator.
RISK_ASSESSMENT_PROVIDER_SPIN_AI Spin.Ai.

RiskAssessment

Đánh giá rủi ro cho một tiện ích Chrome.

Biểu diễn dưới dạng JSON 
{
  "assessment": string,
  "detailsUrl": string,
  "version": string
}
Trường
assessment

string

Kết quả đánh giá rủi ro cho tiện ích. Hiện tại, đây là một giá trị số và cách diễn giải giá trị này là dành riêng cho từng nhà cung cấp dịch vụ đánh giá rủi ro.
detailsUrl

string

URL mà người dùng có thể truy cập để biết thêm thông tin về kết quả đánh giá rủi ro.
version

string

Phiên bản tiện ích mà kết quả đánh giá này áp dụng.

RiskLevel

Mức độ rủi ro theo nhóm cho một tiện ích/ứng dụng.

Enum
RISK_LEVEL_UNSPECIFIED Chưa chỉ định mức độ rủi ro.
RISK_LEVEL_LOW Tiện ích có mức độ rủi ro thấp.
RISK_LEVEL_MEDIUM Phần mở rộng có rủi ro trung bình.
RISK_LEVEL_HIGH Tiện ích có nguy cơ cao.