Method: customers.reports.findSaasUsageBrowsers

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

HTTP リクエスト

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

この 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.findSaasUsageBrowsers 呼び出しから受け取ったページトークン。後続のページを取得するにはこれを指定します。
filter

string

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

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

  • machine
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
  • orgUnitId
orderBy

string

省略可。SaaS ブラウザ レポートを並べ替えるための order by 式。

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

  • machine
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime

デフォルトの順序は昇順です。フィールドに対して降順を指定するには、「desc」を追加します。

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

reports.findSaasUsageBrowsers メソッドに対するレスポンス。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "saasUsageBrowsers": [
    {
      object (SaasUsageBrowser)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
フィールド
saasUsageBrowsers[]

object (SaasUsageBrowser)

SaaS 使用状況ブラウザ レポートのリスト。
nextPageToken

string

次のページを取得するために pageToken として送信できるトークン。
totalSize

string (int64 format)

リクエストに一致する SaaS 使用状況ブラウザ レポートの合計数。

認可スコープ

次の OAuth スコープが必要です。

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

SaasUsageBrowser

SaaS 使用状況ブラウザの詳細。

JSON 表現 
{
  "machine": string,
  "devicePermanentId": string,
  "firstNavigationTime": string,
  "lastNavigationTime": string,
  "orgUnitId": string,
  "osPlatform": enum (DeviceSystem),
  "osVersion": string
}
フィールド
machine

string

出力専用。マシン名。
devicePermanentId

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 のバージョン。