Method: customers.reports.findSaasUsage

根據指定的搜尋和排序條件，找出客戶的 SaaS 用量報表。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
customer

string

必填。以「customers/C」或「customers/my_customer」為前置字串的模糊處理客戶 ID。

查詢參數

參數
pageSize

integer

(選用步驟) 要傳回的報表數量上限。服務傳回的產品數量可能會少於這個值。如未指定，最多將傳回 100 份報表。許可的最大值為 200；超出的數值將一律指定為 200。
pageToken

string

(選用步驟) 屬於接收自前一個 FindSaasUsageReports 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時，提供至 FindSaasUsageReports 的所有其他參數須與提供網頁權杖的呼叫相符。
filter

string

(選用步驟) 篩選運算式，用於縮小要傳回的 SaaS 報表範圍。支援的運算子包括：=、!=、<、<=、>、>=、:。支援的邏輯運算子包括：AND、OR 和 NOT。

支援的欄位：

  • 應用程式
  • orgUnitId
  • firstNavigationTime
  • lastNavigationTime
  • category
  • 組織
  • foundedYear
  • 總部
  • primaryDomain
  • 網域
  • encryptionProtocols
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

範例：(firstNavigationTime < "2026-01-31T00:00:00Z" AND lastNavigationTime > "2026-01-01T00:00:00Z") AND visitsCount > 100
orderBy

string

(選用步驟) 用來排序 SaaS 報表的 ORDER BY 運算式。

支援的欄位：

  • 應用程式
  • category
  • 組織
  • foundedYear
  • 總部
  • primaryDomain
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

預設為遞增排序。如要針對欄位指定遞減順序，請加上「 desc」。

範例：visitsCount desc

要求主體

要求主體必須為空白。

回應主體

reports.findSaasUsage 方法的回應。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "saasReports": [
    {
      object (SaasUsageReport)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
欄位
saasReports[]

object (SaasUsageReport)

SaaS 用量報表清單。
nextPageToken

string

可做為 pageToken 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。
totalSize

string (int64 format)

符合要求的 SaaS 使用情況報告總數。

授權範圍

需要下列 OAuth 範圍：

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

SaasUsageReport

代表單一 SaaS 報表項目。

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
}
欄位
app

string

僅供輸出。應用程式的名稱。
orgUnitId

string

僅供輸出。組織單位的 ID。
category

string

僅供輸出。應用程式類別。
organization

string

僅供輸出。開發應用程式的機構。
foundedYear

integer

僅供輸出。機構成立年份。
headquarters

string

僅供輸出。機構總部所在地。
primaryDomain

string

僅供輸出。應用程式的主網域。
domains[]

string

僅供輸出。與應用程式相關聯的網域和子網域清單。
encryptionProtocols[]

string

僅供輸出。用來存取應用程式的加密通訊協定清單。
visitsCount

string (int64 format)

僅供輸出。應用程式的造訪總數。
distinctUsersCount

string (int64 format)

僅供輸出。曾造訪應用程式的不重複使用者人數。
distinctBrowsersCount

string (int64 format)

僅供輸出。曾造訪應用程式的不重複瀏覽器數量。
contentTransferDetails

object (ContentTransferDetails)

僅供輸出。提供內容轉移事件的相關資訊 (如有)。
firstNavigationTime

string (Timestamp format)

僅供輸出。首次瀏覽應用程式的時間戳記。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
lastNavigationTime

string (Timestamp format)

僅供輸出。上次瀏覽應用程式的時間戳記。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

ContentTransferDetails

提供內容轉移事件的相關資訊 (如有)。

JSON 表示法 
{
  "contentTransferCount": string
}
欄位
contentTransferCount

string (int64 format)

僅供輸出。與應用程式相關聯的內容轉移總數。