说明
使用 chrome.enterprise.deviceAttributes API 读取设备属性。注意:此 API 仅适用于根据企业政策强制安装的扩展程序。
权限
enterprise.deviceAttributes可用性
方法
getDeviceAnnotatedLocation()
chrome.enterprise.deviceAttributes.getDeviceAnnotatedLocation(
callback?: function,
): Promise<string>
获取管理员注释的位置信息。如果当前用户未关联任何机构,或者管理员未设置任何带注释的位置,则返回空字符串。
参数
-
callback
函数 可选
callback参数的格式如下:(annotatedLocation: string) => void
-
annotatedLocation
字符串
-
返回
-
Promise<string>
Chrome 96 及更高版本返回一个 Promise,该 Promise 会解析为设备的带注释的位置。
仅 Manifest V3 及更高版本支持 Promise,其他平台需要使用回调。
getDeviceAssetId()
chrome.enterprise.deviceAttributes.getDeviceAssetId(
callback?: function,
): Promise<string>
获取管理员注释的资产 ID。如果当前用户没有关联的资产,或者管理员未设置任何资产 ID,则返回空字符串。
参数
-
callback
函数 可选
callback参数的格式如下:(assetId: string) => void
-
assetId
字符串
-
返回
-
Promise<string>
Chrome 96 及更高版本返回一个 Promise,该 Promise 会解析为设备的资产 ID。
仅 Manifest V3 及更高版本支持 Promise,其他平台需要使用回调。
getDeviceHostname()
chrome.enterprise.deviceAttributes.getDeviceHostname(
callback?: function,
): Promise<string>
获取由 DeviceHostnameTemplate 政策设置的设备主机名。如果当前用户未关联或企业政策未设置主机名,则返回空字符串。
参数
-
callback
函数 可选
callback参数的格式如下:(hostname: string) => void
-
主机名
字符串
-
返回
-
Promise<string>
Chrome 96 及更高版本返回一个 Promise,该 Promise 会解析为设备的主机名。
仅 Manifest V3 及更高版本支持 Promise,其他平台需要使用回调。
getDeviceSerialNumber()
chrome.enterprise.deviceAttributes.getDeviceSerialNumber(
callback?: function,
): Promise<string>
获取设备的序列号。请注意,此 API 的目的是管理设备(例如,为设备级证书生成证书签名请求)。未经设备管理员同意,不得使用此 API 跟踪设备。如果当前用户没有关联,则返回空字符串。
参数
-
callback
函数 可选
callback参数的格式如下:(serialNumber: string) => void
-
serialNumber
字符串
-
返回
-
Promise<string>
Chrome 96 及更高版本返回一个 Promise,该 Promise 会解析为设备的序列号。
仅 Manifest V3 及更高版本支持 Promise,其他平台需要使用回调。
getDirectoryDeviceId()
chrome.enterprise.deviceAttributes.getDirectoryDeviceId(
callback?: function,
): Promise<string>
获取 Directory API 的设备标识符的值,该值由服务器生成,用于标识设备在 Cloud Directory API 中的云记录,以便在 Cloud Directory API 中进行查询。如果当前用户没有关联,则返回空字符串。
参数
-
callback
函数 可选
callback参数的格式如下:(deviceId: string) => void
-
deviceId
字符串
-
返回
-
Promise<string>
Chrome 96 及更高版本返回一个 Promise,该 Promise 会解析为 Directory API 的设备标识符。
仅 Manifest V3 及更高版本支持 Promise,其他平台需要使用回调。