Method: customers.reports.findSaasUsageProfiles

根據指定的搜尋和排序條件，找出客戶的 SaaS 用量報表 (依設定檔分組)。

HTTP 要求

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

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

路徑參數

參數
customer

string

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

查詢參數

參數
app

string

必填。軟體即服務 (SaaS) 應用程式的名稱 (例如 ChatGPT、Gemini)。
pageSize

integer

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

string

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

string

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

支援的欄位：

  • 電子郵件
  • orgUnitId
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
orderBy

string

(選用步驟) 用來排序 SaaS 設定檔報表的排序依據運算式。

支援的欄位：

  • 電子郵件
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime

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

要求主體

要求主體必須為空白。

回應主體

reports.findSaasUsageProfiles 方法的回應。

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

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

object (SaasUsageProfileReport)

SaaS 用量設定檔報表清單。
nextPageToken

string

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

string (int64 format)

符合要求的 SaaS 用量設定檔報表總數。

授權範圍

需要下列 OAuth 範圍：

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

SaasUsageProfileReport

代表依設定檔分組的單一 SaaS 報告項目。

JSON 表示法 
{
  "email": string,
  "profilePermanentId": string,
  "firstNavigationTime": string,
  "lastNavigationTime": string,
  "orgUnitId": string,
  "osPlatform": enum (DeviceSystem),
  "osVersion": string
}
欄位
email

string

僅供輸出。使用者的電子郵件地址。
profilePermanentId

string

僅供輸出。設定檔的永久 ID。
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"。
orgUnitId

string

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

enum (DeviceSystem)

僅供輸出。作業系統平台。
osVersion

string

僅供輸出。作業系統版本。