Method: customers.profiles.list

指定された検索条件と並べ替え条件に基づいて、お客様の Chrome ブラウザ プロフィールを一覧表示します。

HTTP リクエスト

GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/profiles

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

パスパラメータ

パラメータ
parent

string

必須。形式: customers/{customer_id}

クエリ パラメータ

パラメータ
pageSize

integer

省略可。返されるプロフィールの最大数。pageSize が指定されていない場合、デフォルトのページサイズは 100 で、最大ページサイズは 200 です。
pageToken

string

省略可。リスティング リクエストの特定のページを取得するために使用されるページトークン。
filter

string

省略可。プロファイルをフィルタするために使用されるフィルタ。フィルタでは、次のフィールドを使用できます。

  • profileId
  • displayName
  • userEmail
  • lastActivityTime
  • lastPolicySyncTime
  • lastStatusReportTime
  • firstEnrollmentTime
  • osPlatformType
  • osVersion
  • browserVersion
  • browserChannel
  • policyCount
  • extensionCount
  • identityProvider
  • affiliationState
  • osPlatformVersion
  • ouId

上記のいずれかのフィールドを使用してフィルタを指定できます。複数のフィールドによるフィルタリングは、AND 演算子でサポートされています。文字列型フィールドと列挙型フィールドは、= 演算子と != 演算子をサポートしています。整数型とタイムスタンプ型のフィールドは、=、!=、<、>、<=、>= 演算子をサポートしています。タイムスタンプには、RFC-3339 形式の文字列（例: 2012-04-21T11:30:00-04:00）を指定します。ワイルドカード「*」は、文字列タイプのフィールド フィルタで使用できます。また、文字列リテラルのフィルタリングもサポートされています。たとえば、フィルタとして「ABC」を指定すると、フィルタ可能な文字列型フィールドのいずれかに「ABC」が含まれているかどうかを確認するフィルタにマッピングされます。

組織部門番号をフィルタ条件として使用するには、「ouId = ${your_org_unit_id}」と指定します。ただし、OU ID の一致は 1 つだけサポートされます。
orderBy

string

省略可。結果の並べ替えに使用されるフィールド。サポートされているフィールドは次のとおりです。

  • profileId
  • displayName
  • userEmail
  • lastActivityTime
  • lastPolicySyncTime
  • lastStatusReportTime
  • firstEnrollmentTime
  • osPlatformType
  • osVersion
  • browserVersion
  • browserChannel
  • policyCount
  • extensionCount
  • identityProvider
  • affiliationState
  • osPlatformVersion

デフォルトでは並べ替えは昇順で行われますが、フィールドに対して降順を指定するには、フィールド名に接尾辞「desc」を追加する必要があります。デフォルトの並べ替え順序は、lastStatusReportTime の降順です。

リクエストの本文

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

レスポンスの本文

profiles.list メソッドのレスポンス。

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

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

object (ChromeBrowserProfile)

返されたプロファイルのリスト。
nextPageToken

string

次のページを一覧表示するために使用できるページ設定トークン。
totalSize

string (int64 format)

合計サイズは、返されるリソースの推定数を表します。1 万件を超えるプロフィールについては、正確性を保証するものではありません。

認可スコープ

以下のいずれかの OAuth スコープが必要です。

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