Method: customers.profiles.list

根據指定的搜尋和排序條件，列出客戶的 Chrome 瀏覽器設定檔。

HTTP 要求

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

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

路徑參數

參數
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 比對。
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