REST Resource: customers.chromeBrowsers

資源:ChromeBrowser

搭載受管理 Chrome 瀏覽器的裝置。

JSON 表示法
{
  "name": string,
  "browserPermanentId": string,
  "lastPolicyFetchTime": string,
  "osPlatform": string,
  "osArchitecture": string,
  "osVersion": string,
  "machineName": string,
  "annotatedLocation": string,
  "annotatedUser": string,
  "annotatedAssetId": string,
  "annotatedNotes": string,
  "lastRegistrationTime": string,
  "extensionCount": string,
  "policyCount": string,
  "lastDeviceUser": string,
  "lastActivityTime": string,
  "osPlatformVersion": string,
  "browserVersions": [
    string
  ],
  "lastStatusReportTime": string,
  "lastDeviceUsers": [
    {
      object (BrowserUser)
    }
  ],
  "machinePolicies": [
    {
      object (Policy)
    }
  ],
  "browsers": [
    {
      object (Browser)
    }
  ],
  "serialNumber": string,
  "virtualDeviceId": string,
  "machineExtensionPolicies": [
    {
      object (ExtensionPolicy)
    }
  ],
  "orgUnitId": string,
  "deviceIdentifiersHistory": {
    object (DeviceIdentifiersHistory)
  },
  "attestationCredential": {
    object (AttestationCredential)
  },
  "omahaRecentFetchTime": string
}
欄位
name

string

ID。格式:customers/{customerId}/chromeBrowsers/{browserPermanentId}

browserPermanentId

string

僅供輸出。Chrome 瀏覽器的專屬 ID。

lastPolicyFetchTime

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"。

osPlatform

string

僅供輸出。裝置 OS 平台。

osArchitecture

string

僅供輸出。裝置 CPU 架構。

osVersion

string

僅供輸出。裝置 OS 版本。

machineName

string

僅供輸出。電腦名稱。

annotatedLocation

string

(選用步驟) 系統管理員註記的裝置位址或位置。

annotatedUser

string

(選用步驟) 系統管理員註記的裝置使用者。

annotatedAssetId

string

(選用步驟) 系統管理員註記或您在註冊時指定的資產 ID。

annotatedNotes

string

(選用步驟) 系統管理員為這部裝置加註的附註。

lastRegistrationTime

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"。

extensionCount

string (int64 format)

僅供輸出。這個裝置上所有 Chrome 瀏覽器安裝的不同擴充功能數量。

policyCount

string (int64 format)

僅供輸出。這個裝置上所有 Chrome 瀏覽器設定的不同政策數量。

lastDeviceUser

string

僅供輸出。上次在這部裝置上登入 Chrome 瀏覽器的使用者。

lastActivityTime

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"。

osPlatformVersion

string

僅供輸出。裝置 OS 平台和版本組合。

browserVersions[]

string

僅供輸出。這部裝置上安裝的所有瀏覽器版本清單。

lastStatusReportTime

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"。

lastDeviceUsers[]

object (BrowserUser)

僅供輸出。近期瀏覽器使用者清單,依上次回報時間降序排列。

machinePolicies[]

object (Policy)

僅供輸出。這部裝置上 Chrome 瀏覽器設定的所有裝置層級政策清單。

browsers[]

object (Browser)

僅供輸出。這部裝置上安裝的 Chrome 瀏覽器清單。

serialNumber

string

僅供輸出。裝置序號。

virtualDeviceId

string

僅供輸出。註冊這部裝置的第一個 Chrome 瀏覽器傳送的初始裝置 ID。

machineExtensionPolicies[]

object (ExtensionPolicy)

僅供輸出。這份清單列出為此裝置上 Chrome 安裝的擴充功能設定的所有裝置層級政策。

orgUnitId

string

僅供輸出。瀏覽器的模糊處理組織單位 ID。

deviceIdentifiersHistory

object (DeviceIdentifiersHistory)

僅供輸出。向這部裝置回報的 ID 記錄。

attestationCredential

object (AttestationCredential)

僅供輸出。用於裝置信任連接器的認證憑證。

omahaRecentFetchTime

string (Timestamp format)

僅供輸出。Omaha 近期擷取政策的活動。不一定是上次擷取的時間,因為這個欄位只會每天更新。

使用 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"。

BrowserUser

Chrome 瀏覽器使用者。

JSON 表示法
{
  "userName": string,
  "lastStatusReportTime": string
}
欄位
userName

string

僅供輸出。登入 Chrome 的使用者名稱。

lastStatusReportTime

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"。

政策

受管理 Chrome 瀏覽器回報的已套用政策。這項政策可套用至各種範圍 (電腦、設定檔、擴充功能)。

JSON 表示法
{
  "source": enum (PolicySource),
  "policyName": string,
  "value": string,
  "error": string
}
欄位
source

enum (PolicySource)

僅供輸出。政策來源。

policyName

string

僅供輸出。政策名稱。

value

string

僅供輸出。政策值。

error

string

僅供輸出。嘗試套用這項政策時回報的所有錯誤 (如有),以本地化字串表示。

瀏覽器

在 Chrome 瀏覽器受管理的裝置上安裝 Chrome。

JSON 表示法
{
  "browserVersion": string,
  "channel": enum (Channel),
  "lastStatusReportTime": string,
  "lastPolicyFetchTime": string,
  "executablePath": string,
  "plugins": [
    {
      object (Plugin)
    }
  ],
  "profiles": [
    {
      object (Profile)
    }
  ],
  "pendingInstallVersion": string
}
欄位
browserVersion

string

僅供輸出。已安裝的瀏覽器版本。

channel

enum (Channel)

僅供輸出。已安裝瀏覽器的發布版本。

lastStatusReportTime

string (Timestamp format)

僅供輸出。上次收到這個 Chrome 瀏覽器報告的時間。

使用 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"。

lastPolicyFetchTime

string (Timestamp format)

僅供輸出。這個 Chrome 瀏覽器上次成功擷取政策的時間。

使用 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"。

executablePath

string

僅供輸出。這個瀏覽器的 Chrome.exe 可執行檔路徑。

plugins[]

object (Plugin)

僅供輸出。這個 Chrome 瀏覽器上安裝的所有外掛程式清單。

profiles[]

object (Profile)

僅供輸出。這個瀏覽器的設定檔清單。

pendingInstallVersion

string

僅供輸出。安裝瀏覽器的待處理版本。只有在目前使用的瀏覽器版本與「browserVersion」不同時,才會設定這個欄位。

頻道

瀏覽器的可能發布版本。

列舉
CHANNEL_UNSPECIFIED 代表未指定的管道。
CHANNEL_STABLE 代表穩定版。
CHANNEL_BETA 代表 Beta 版。
CHANNEL_DEV 代表開發管道。
CHANNEL_CANARY 代表 Canary 管道。

外掛程式

裝置上受管理 Chrome 瀏覽器回報的 Chrome 安裝項目中,安裝的 Chrome 瀏覽器外掛程式相關資訊。

JSON 表示法
{
  "pluginName": string,
  "description": string,
  "filename": string
}
欄位
pluginName

string

僅供輸出。已安裝外掛程式的名稱。

description

string

僅供輸出。已安裝外掛程式的說明。

filename

string

僅供輸出。已安裝外掛程式的檔案名稱。

個人資料

在安裝 Chrome 的裝置上回報設定檔,且該裝置具有受管理的 Chrome 瀏覽器。

JSON 表示法
{
  "profileName": string,
  "id": string,
  "lastStatusReportTime": string,
  "lastPolicyFetchTime": string,
  "safeBrowsingWarnings": string,
  "safeBrowsingWarningsClickThroughs": string,
  "chromeSignedInUserEmail": string,
  "extensions": [
    {
      object (Extension)
    }
  ],
  "userPolicies": [
    {
      object (Policy)
    }
  ],
  "extensionPolicies": [
    {
      object (ExtensionPolicy)
    }
  ],
  "safeBrowsingWarningsResetTime": string
}
欄位
profileName

string

僅供輸出。這個設定檔的名稱。

id

string

僅供輸出。這個設定檔的專屬 ID。

lastStatusReportTime

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"。

lastPolicyFetchTime

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"。

safeBrowsingWarnings

string (int64 format)

僅供輸出。這個設定檔顯示的安全瀏覽警告數量。

safeBrowsingWarningsClickThroughs

string (int64 format)

僅供輸出。這個設定檔中遭點閱的安全瀏覽警告數量。

chromeSignedInUserEmail

string

僅供輸出。登入這個設定檔的使用者電子郵件地址 (如有)。

extensions[]

object (Extension)

僅供輸出。這個設定檔已安裝的擴充功能清單。

userPolicies[]

object (Policy)

僅供輸出。套用至這個設定檔的 Chrome 瀏覽器政策清單。

extensionPolicies[]

object (ExtensionPolicy)

僅供輸出。已套用擴充功能政策的擴充功能清單。

safeBrowsingWarningsResetTime

string (Timestamp format)

僅供輸出。上次將安全瀏覽警告資訊重設為 0 的時間。

使用 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"。

額外資訊

在已安裝 Chrome 的裝置上,如果 Chrome 瀏覽器受管理,系統會回報設定檔中安裝的擴充功能資訊。

JSON 表示法
{
  "extensionId": string,
  "version": string,
  "permissions": [
    string
  ],
  "extensionName": string,
  "description": string,
  "appType": enum (ExtensionType),
  "homepageUri": string,
  "installType": enum (InstallationType),
  "configuredAppPolicy": enum (ConfiguredAppPolicy),
  "disabled": boolean,
  "icons": [
    {
      object (ExtensionIcon)
    }
  ],
  "manifestVersion": integer
}
欄位
extensionId

string

僅供輸出。擴充功能的 ID。

version

string

僅供輸出。擴充功能的版本。

permissions[]

string

僅供輸出。這項擴充功能所需的權限清單。

extensionName

string

僅供輸出。Chrome 回報的擴充功能本地化名稱。

description

string

僅供輸出。這項擴充功能的本地化說明。

appType

enum (ExtensionType)

僅供輸出。擴充功能的類型。

homepageUri

string

僅供輸出。這項擴充功能的首頁網址。

installType

enum (InstallationType)

僅供輸出。擴充功能的安裝方式。

configuredAppPolicy

enum (ConfiguredAppPolicy)

僅供輸出。如果擴充功能是由瀏覽器政策控管。

disabled

boolean

僅供輸出。擴充功能是否已停用。

icons[]

object (ExtensionIcon)

僅供輸出。這項擴充功能可用的圖示清單。

manifestVersion

integer

僅供輸出。這項擴充功能的資訊清單版本。

ConfiguredAppPolicy

擴充功能可能已設定的應用程式政策。

列舉
CONFIGURED_APP_POLICY_UNSPECIFIED 代表未指定的已設定應用程式政策。
CONFIGURED_APP_POLICY_NONE 代表未設定的應用程式政策。
CONFIGURED_APP_POLICY_SHOULD_FORCE 代表應強制執行的擴充功能。
CONFIGURED_APP_POLICY_SHOULD_BLOCK 代表應封鎖的擴充功能。

ExtensionIcon

Chrome 瀏覽器擴充功能圖示。

JSON 表示法
{
  "size": integer,
  "uri": string
}
欄位
size

integer

僅供輸出。擴充功能圖示的大小。

uri

string

僅供輸出。擴充功能圖示的網址。

ExtensionPolicy

套用至 Chrome 設定檔中已安裝擴充功能的政策。

JSON 表示法
{
  "extensionId": string,
  "extensionName": string,
  "policies": [
    {
      object (Policy)
    }
  ]
}
欄位
extensionId

string

僅供輸出。政策套用的擴充功能 ID。

extensionName

string

僅供輸出。政策套用的擴充功能名稱。

policies[]

object (Policy)

僅供輸出。套用至這項擴充功能的政策清單。

DeviceIdentifiersHistory

裝置回報的裝置 ID 記錄。

JSON 表示法
{
  "records": [
    {
      object (DeviceIdentifiersRecord)
    }
  ],
  "deviceIdCollision": boolean,
  "lastDeviceIdCollisionDetectionTime": string
}
欄位
records[]

object (DeviceIdentifiersRecord)

僅供輸出。這部裝置傳送的裝置 ID 清單。依 lastActivityTime 遞減排序。

deviceIdCollision

boolean

僅供輸出。裝置 ID 可能由多部裝置使用。

lastDeviceIdCollisionDetectionTime

string (Timestamp format)

僅供輸出。我們上次偵測到裝置 ID 衝突的時間。

使用 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"。

DeviceIdentifiersRecord

裝置 ID 記錄和回報時間。

JSON 表示法
{
  "identifiers": {
    object (DeviceIdentifiers)
  },
  "firstRecordTime": string,
  "lastActivityTime": string
}
欄位
identifiers

object (DeviceIdentifiers)

僅供輸出。裝置 ID。

firstRecordTime

string (Timestamp format)

僅供輸出。首次回報這些 ID 的時間。

使用 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"。

lastActivityTime

string (Timestamp format)

僅供輸出。這些 ID 上次活動的時間,包括回報、擷取政策或註冊。

使用 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"。

DeviceIdentifiers

蒐集裝置 ID。

JSON 表示法
{
  "machineName": string,
  "serialNumber": string,
  "hostName": string
}
欄位
machineName

string

僅供輸出。與裝置相關聯的裝置名稱。

serialNumber

string

僅供輸出。裝置序號。

hostName

string

僅供輸出。裝置的主機名稱。

方法

delete

刪除從 Chrome 瀏覽器設定檔收集的資料。

get

擷取由客戶 ID 和資源 ID 識別的單一 Chrome 瀏覽器。

list

擷取客戶的所有 Chrome 瀏覽器 (分頁)。

move

將受管理的 Chrome 瀏覽器移至新的機構單位 (OU)。

patch

更新 Chrome 瀏覽器的註解資訊。