Method: customers.reports.findSaasUsageBrowsers

Tìm báo cáo về mức sử dụng SaaS của một khách hàng được nhóm theo trình duyệt dựa trên tiêu chí tìm kiếm và sắp xếp đã cho.

Yêu cầu HTTP

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

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ã nhận dạng khách hàng bị làm rối có tiền tố "customers/C" hoặc "customers/my_customer".

Tham số truy vấn

Tham số
app

string

Bắt buộc. Tên của ứng dụng SaaS (ví dụ: ChatGPT, Gemini).
pageSize

integer

Không bắt buộc. Số lượng trình duyệt tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu bạn không chỉ định, hệ thống sẽ trả về tối đa 100 trình duyệt. Giá trị tối đa là 200; các giá trị trên 200 sẽ được chuyển đổi thành 200.
pageToken

string

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

string

Không bắt buộc. Biểu thức bộ lọc để thu hẹp các báo cáo về trình duyệt SaaS cần trả về. Các toán tử được hỗ trợ là: =, !=, <, <=, >, >=, :. Các toán tử logic AND, OR và NOT được hỗ trợ.

Các trường được hỗ trợ:

  • máy
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
  • orgUnitId
orderBy

string

Không bắt buộc. Biểu thức sắp xếp để sắp xếp báo cáo trình duyệt SaaS.

Các trường được hỗ trợ:

  • máy
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime

Thứ tự mặc định là tăng dần. Để chỉ định thứ tự giảm dần cho một trường, hãy thêm " desc".

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 đối với phương thức reports.findSaasUsageBrowsers.

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

object (SaasUsageBrowser)

Danh sách báo cáo về trình duyệt sử dụng SaaS.
nextPageToken

string

Một mã thông báo có thể được gửi dưới dạng pageToken để truy xuất trang tiếp theo.
totalSize

string (int64 format)

Tổng số báo cáo về mức sử dụng SaaS trên trình duyệt trùng 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

SaasUsageBrowser

Thông tin chi tiết về trình duyệt sử dụng SaaS.

Biểu diễn dưới dạng JSON 
{
  "machine": string,
  "devicePermanentId": string,
  "firstNavigationTime": string,
  "lastNavigationTime": string,
  "orgUnitId": string,
  "osPlatform": enum (DeviceSystem),
  "osVersion": string
}
Trường
machine

string

Chỉ có đầu ra. Tên máy.
devicePermanentId

string

Chỉ có đầu ra. Mã vĩnh viễn của thiết bị.
firstNavigationTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian khi trình duyệt này lần đầu tiên chuyển đến ứng dụng.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
lastNavigationTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian khi trình duyệt này chuyển đến ứng dụng lần gần đây nhất.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
orgUnitId

string

Chỉ có đầu ra. Mã nhận dạng của đơn vị tổ chức.
osPlatform

enum (DeviceSystem)

Chỉ có đầu ra. Nền tảng hệ điều hành.
osVersion

string

Chỉ có đầu ra. Phiên bản hệ điều hành.