Method: customers.reports.findSaasUsageProfiles

指定された検索条件と並べ替え条件に基づいて、プロファイルごとにグループ化された顧客の SaaS 使用状況レポートを取得します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
customer

string

必須。「customers/C」または「customers/my_customer」の接頭辞が付いた難読化されたお客様 ID。

クエリ パラメータ

パラメータ
app

string

必須。SaaS アプリケーションの名前（ChatGPT、Gemini など）。
pageSize

integer

省略可。返すレポートの最大数。サービスが返す値はこれよりも少ないことがあります。指定されていない場合は、最大で 100 件のレポートが返されます。最大値は 200 です。200 を超える値は 200 に強制変換されます。
pageToken

string

省略可。前回の reports.findSaasUsageProfiles 呼び出しから受け取ったページトークン。後続のページを取得するにはこれを指定します。
filter

string

省略可。返す SaaS プロファイル レポートを絞り込むためのフィルタ式。サポートされている演算子は、=、!=、<、<=、>、>=、: です。論理演算子 AND、OR、NOT がサポートされています。

サポートされているフィールド:

  • メール
  • orgUnitId
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
orderBy

string

省略可。SaaS プロファイル レポートを並べ替えるための order by 式。

サポートされているフィールド:

  • メール
  • 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)

出力専用。OS プラットフォーム。
osVersion

string

出力専用。OS のバージョン。