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

标识符。格式：customers/{customerId}/chromeBrowsers/{browserPermanentId}
browserPermanentId

string

仅限输出。Chrome 浏览器的唯一标识符。
lastPolicyFetchTime

string (Timestamp format)

仅限输出。相应设备上次成功提取政策的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 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

仅限输出。设备操作系统平台。
osArchitecture

string

仅限输出。设备 CPU 架构。
osVersion

string

仅限输出。设备操作系统版本。
machineName

string

仅限输出。机器名称。
annotatedLocation

string

可选。管理员注释的设备的地址或位置。
annotatedUser

string

可选。管理员注释的设备用户。
annotatedAssetId

string

可选。管理员注释或在注册期间指定的资产标识符。
annotatedNotes

string

可选。管理员注释的此设备的说明。
lastRegistrationTime

string (Timestamp format)

仅限输出。设备上次尝试注册的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 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 规范化（即转换为 UTC 零时区格式并在末尾附加 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

仅限输出。设备操作系统平台和版本组合。
browserVersions[]

string

仅限输出。此设备上安装的所有浏览器版本的列表。
lastStatusReportTime

string (Timestamp format)

仅限输出。设备上次发送状态报告的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 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)

仅限输出。报告给此设备的标识符的历史记录。
attestationCredential

object (AttestationCredential)

仅限输出。用于设备信任连接器的证明凭据。
omahaRecentFetchTime

string (Timestamp format)

仅限输出。Omaha 近期政策提取活动。不一定是上次提取，因为此字段仅每天更新一次。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 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 规范化（即转换为 UTC 零时区格式并在末尾附加 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 规范化（即转换为 UTC 零时区格式并在末尾附加 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 规范化（即转换为 UTC 零时区格式并在末尾附加 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 浏览器的设备上报告的个人资料。

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 规范化（即转换为 UTC 零时区格式并在末尾附加 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 规范化（即转换为 UTC 零时区格式并在末尾附加 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 规范化（即转换为 UTC 零时区格式并在末尾附加 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

设备报告的设备标识符的历史记录。

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

object (DeviceIdentifiersRecord)

仅限输出。相应设备发送的设备标识符列表。按 lastActivityTime 降序排序。
deviceIdCollision

boolean

仅限输出。设备 ID 可能正被多台设备使用。
lastDeviceIdCollisionDetectionTime

string (Timestamp format)

仅限输出。上次检测到设备 ID 冲突的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 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

设备标识符及其报告时间的记录。

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

object (DeviceIdentifiers)

仅限输出。设备标识符。
firstRecordTime

string (Timestamp format)

仅限输出。首次报告这些标识符的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 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)

仅限输出。这些标识符上次活动的时间，无论是报告、政策提取还是注册。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 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

设备标识符的集合。

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 浏览器的注释信息。