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

Tham 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ố lượng 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 cần đượ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 theo cú pháp EBNF.

Lưu ý: Bộ lọc này không hỗ trợ các thao tác OR.

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

  • tên ứng dụng
  • 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ợ để sắp xếp theo:

  • tên ứng dụng
  • 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

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 riêng biệ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, đó là 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. Ứng dụng có bị vô hiệu hoá hay không.
appSource

enum (AppSource)

Chỉ có đầu ra. Nguồn của ứng dụng cần 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ần 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. Nếu có, dữ liệu đánh giá rủi ro về tiện ích này.

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ần 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 Bạn chưa chỉ định loại cài đặt ứng dụng.
MULTIPLE Nhiều loại lượt 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 của quản trị viên.
DEVELOPMENT Loại cài đặt ứng dụng phát triển.
SIDELOAD Loại cài đặt ứng dụng tải qua phương thức bên.
OTHER Loại cài đặt ứng dụng khác.

AppSource

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

Enum
APP_SOURCE_UNSPECIFIED Chưa chỉ định nguồn ứng dụng.
CHROME_WEBSTORE Thường là đối với 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 về 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à cấp độ rủi ro cao nhất trong tất cả các mục nhập.

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)

Chỉ có đầu ra. Nhà cung cấp dịch vụ đánh giá rủi ro mà mục này đến từ đó.
riskAssessment

object (RiskAssessment)

Chỉ có đầu ra. Thông tin chi tiết về hoạt động đánh giá rủi ro của nhà cung cấp.
riskLevel

enum (RiskLevel)

Chỉ có đầu ra. Mức độ rủi ro theo nhóm để đá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 có nhà cung cấp nào được chỉ định.
RISK_ASSESSMENT_PROVIDER_CRXCAVATOR CRXcavator.
RISK_ASSESSMENT_PROVIDER_SPIN_AI Spin.Ai.
RISK_ASSESSMENT_PROVIDER_LAYERX LayerX Security.
RISK_ASSESSMENT_PROVIDER_SPIN_AI_V2 Spin.AI V2.

RiskAssessment

Đánh giá rủi ro đối với tiện ích của Chrome.

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

string

Đánh giá rủi ro cho tiện ích. Hiện tại, đây là một giá trị bằng số và cách diễn giải giá trị này là riêng biệt đối với 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ề việc đánh giá rủi ro.
version

string

Phiên bản của tiện ích mà hoạt động đá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 đại diện cho một miền có độ rủi ro thấp.
RISK_LEVEL_MEDIUM Tiện ích đại diện cho rủi ro trung bình.
RISK_LEVEL_HIGH Tiện ích đại diện cho rủi ro cao.