Method: customers.reports.findSaasUsage

指定された検索条件と並べ替え条件に基づいて、お客様の SaaS 使用状況レポートを検索します。

HTTP リクエスト

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

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

パスパラメータ

パラメータ
customer

string

必須。「customers/C」または「customers/my_customer」で始まる難読化されたお客様 ID。

クエリ パラメータ

パラメータ
pageSize

integer

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

string

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

ページ分割を行う場合、FindSaasUsageReports に指定する他のすべてのパラメータは、ページトークンを提供した呼び出しと一致する必要があります。
filter

string

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

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

  • アプリ
  • orgUnitId
  • firstNavigationTime
  • lastNavigationTime
  • カテゴリ
  • 組織
  • 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 レポートを並べ替える順序式。

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

  • アプリ
  • カテゴリ
  • 組織
  • 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)

出力専用。アプリに関連付けられたコンテンツ転送の合計数。