Method: customers.reports.findSaasUsage

Tìm báo cáo về việc sử dụng SaaS của một khách hàng 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:findSaasUsage

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

Thông số
pageSize

integer

Không bắt buộc. Số lượng báo cáo tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu không chỉ định, hệ thống sẽ trả về tối đa 100 báo cáo. 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 FindSaasUsageReports trước đó. Cung cấp thông tin 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 FindSaasUsageReports phải khớp với lệnh gọi đã cung cấp mã thông báo trang.
filter

string

Không bắt buộc. Biểu thức bộ lọc để thu hẹp các báo cáo 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ợ:

  • ứng dụng
  • orgUnitId
  • firstNavigationTime
  • lastNavigationTime
  • category
  • tổ chức
  • foundedYear
  • trụ sở chính
  • primaryDomain
  • tên miền
  • encryptionProtocols
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

Ví dụ: (firstNavigationTime < "2026-01-31T00:00:00Z" AND lastNavigationTime > "2026-01-01T00:00:00Z") AND visitsCount > 100
orderBy

string

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

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

  • ứng dụng
  • category
  • tổ chức
  • foundedYear
  • trụ sở chính
  • primaryDomain
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

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".

Ví dụ: visitsCount 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.findSaasUsage.

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

object (SaasUsageReport)

Danh sách báo cáo về mức 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. Nếu bạn bỏ qua trường này, thì sẽ không có các trang tiếp theo.
totalSize

string (int64 format)

Tổng số báo cáo sử dụng SaaS 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

SaasUsageReport

Đại diện cho một mục báo cáo SaaS duy nhất.

Biểu diễn dưới dạng JSON 
{
  "app": string,
  "orgUnitId": string,
  "category": string,
  "organization": string,
  "foundedYear": integer,
  "headquarters": string,
  "primaryDomain": string,
  "domains": [
    string
  ],
  "encryptionProtocols": [
    string
  ],
  "visitsCount": string,
  "distinctUsersCount": string,
  "distinctBrowsersCount": string,
  "contentTransferDetails": {
    object (ContentTransferDetails)
  },
  "firstNavigationTime": string,
  "lastNavigationTime": string
}
Trường
app

string

Chỉ có đầu ra. Tên ứng dụng.
orgUnitId

string

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

string

Chỉ có đầu ra. Danh mục của ứng dụng.
organization

string

Chỉ có đầu ra. Tổ chức phát triển ứng dụng.
foundedYear

integer

Chỉ có đầu ra. Năm thành lập tổ chức.
headquarters

string

Chỉ có đầu ra. Vị trí trụ sở của tổ chức.
primaryDomain

string

Chỉ có đầu ra. Miền chính của ứng dụng.
domains[]

string

Chỉ có đầu ra. Danh sách các miền và miền con được liên kết với ứng dụng.
encryptionProtocols[]

string

Chỉ có đầu ra. Danh sách các giao thức mã hoá được dùng để truy cập vào ứng dụng.
visitsCount

string (int64 format)

Chỉ có đầu ra. Tổng số lượt truy cập vào ứng dụng.
distinctUsersCount

string (int64 format)

Chỉ có đầu ra. Số người dùng riêng biệt đã truy cập vào ứng dụng.
distinctBrowsersCount

string (int64 format)

Chỉ có đầu ra. Số lượng trình duyệt riêng biệt đã truy cập vào ứng dụng.
contentTransferDetails

object (ContentTransferDetails)

Chỉ có đầu ra. Cung cấp thông tin về các sự kiện chuyển nội dung (nếu có).
firstNavigationTime

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian khi ứng dụng được chuyển đến lần đầu tiên.

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 ứng dụng được chuyển đến 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".

ContentTransferDetails

Cung cấp thông tin về các sự kiện chuyển nội dung (nếu có).

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

string (int64 format)

Chỉ có đầu ra. Tổng số lượt chuyển nội dung liên kết với ứng dụng.