chrome.enterprise.deviceAttributes

refresh date: 2026-09-25 robots: noindex

說明

使用 chrome.enterprise.deviceAttributes API 讀取裝置屬性。注意：這個 API 僅適用於依企業政策強制安裝的擴充功能。

權限

enterprise.deviceAttributes

可用性

Chrome 46 以上版本 僅適用於 ChromeOS 需要政策

方法

getDeviceAnnotatedLocation()

Promise Chrome 66+ 
chrome.enterprise.deviceAttributes.getDeviceAnnotatedLocation(
  callback?: function,
): Promise<string>

擷取管理員註記的位置。如果目前使用者未隸屬於任何機構，或管理員未設定任何註解位置，則會傳回空白字串。

參數

  • callback

    函式 選填

    callback 參數如下： 

    (annotatedLocation: string) => void

    • annotatedLocation

      字串

傳回

  • Promise<string>

    Chrome 96 以上版本

    傳回 Promise，並解析為裝置的註解位置。

    Promise 僅適用於 Manifest V3 以上版本，其他平台則須使用回呼。

getDeviceAssetId()

Promise Chrome 66 以上版本 
chrome.enterprise.deviceAttributes.getDeviceAssetId(
  callback?: function,
): Promise<string>

擷取管理員註記的資產 ID。如果目前的使用者未隸屬於任何機構，或管理員未設定資產 ID，則會傳回空白字串。

參數

  • callback

    函式 選填

    callback 參數如下： 

    (assetId: string) => void

    • assetId

      字串

傳回

  • Promise<string>

    Chrome 96 以上版本

    傳回 Promise，其解析結果為裝置的資產 ID。

    Promise 僅適用於 Manifest V3 以上版本，其他平台則須使用回呼。

getDeviceHostname()

Promise Chrome 82+ 
chrome.enterprise.deviceAttributes.getDeviceHostname(
  callback?: function,
): Promise<string>

擷取 DeviceHostnameTemplate 政策設定的裝置主機名稱。如果目前的使用者未與任何機構建立關聯，或企業政策未設定主機名稱，則會傳回空白字串。

參數

  • callback

    函式 選填

    callback 參數如下： 

    (hostname: string) => void

    • 主機名稱

      字串

傳回

  • Promise<string>

    Chrome 96 以上版本

    傳回 Promise，其會解析為裝置的主機名稱。

    Promise 僅適用於 Manifest V3 以上版本，其他平台則須使用回呼。

getDeviceSerialNumber()

Promise Chrome 66+ 
chrome.enterprise.deviceAttributes.getDeviceSerialNumber(
  callback?: function,
): Promise<string>

擷取裝置序號。請注意，這個 API 的用途是管理裝置 (例如產生裝置通用憑證的憑證簽署要求)。未經裝置管理員同意，不得使用這個 API 追蹤裝置。如果目前使用者未隸屬於任何機構，則傳回空白字串。

參數

  • callback

    函式 選填

    callback 參數如下： 

    (serialNumber: string) => void

    • serialNumber

      字串

傳回

  • Promise<string>

    Chrome 96 以上版本

    傳回 Promise，其中包含裝置序號。

    Promise 僅適用於 Manifest V3 以上版本，其他平台則須使用回呼。

getDirectoryDeviceId()

Promise 
chrome.enterprise.deviceAttributes.getDirectoryDeviceId(
  callback?: function,
): Promise<string>

擷取 Directory API 裝置 ID 的值，該值由伺服器產生，用於識別裝置的雲端記錄，以便在 Cloud Directory API 中查詢。如果目前使用者未隸屬於任何機構，則傳回空白字串。

參數

  • callback

    函式 選填

    callback 參數如下： 

    (deviceId: string) => void

    • deviceId

      字串

傳回

  • Promise<string>

    Chrome 96 以上版本

    傳回 Promise，並使用 Directory API 的裝置 ID 解析。

    Promise 僅適用於 Manifest V3 以上版本，其他平台則須使用回呼。