Method: chromeosdevices.action

請改用 BatchChangeChromeOsDeviceStatus。採取會影響 ChromeOS 裝置的動作。包括解除裝置授權、停用和重新啟用裝置。

HTTP 要求

POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action

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

路徑參數

參數
customerId

string

客戶 Google Workspace 帳戶的專屬 ID。身為帳戶管理員，您也可以使用 my_customer 別名來代表帳戶的 customerId。系統也會在 使用者資源中傳回 customerId。
resourceId

string

裝置的專屬 ID。系統會透過 chromeosdevices.list 方法，在回應中傳回 resourceId。

要求主體

要求主體包含 ChromeOsDeviceAction 的例項。

回應主體

如果成功，回應會是一般 HTTP 回應，其格式由方法定義。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/admin.directory.device.chromeos

詳情請參閱授權指南。

ChromeOsDeviceAction

關於 Chrome OS 裝置狀態更新的資料。

JSON 表示法 
{
  "action": string,
  "deprovisionReason": string
}
欄位
action

string

在 Chrome OS 裝置上執行的 chromeosdevices.action。

可接受的值如下：

  • deprovision：如果裝置已不再使用、正在轉售，或是要送回維修 / 退貨，請使用取消佈建動作，將裝置從管理系統中移除。
  • disable：如果您認為貴機構的裝置遺失或遭竊，可以停用該裝置，讓其他人無法使用。當裝置遭到停用時，使用者開啟 Chrome 裝置後，會看到畫面上顯示裝置已停用，以及你指定的聯絡資訊，以便使用者將裝置退回。
  • reenable：在找到遺失的裝置或退回遺失的裝置時，重新啟用已停用的裝置。如果不小心將 Chrome 裝置標示為已停用，也可以使用這項功能。
  • pre_provisioned_disable：無法註冊的預先佈建裝置。管理員可以將裝置狀態變更為「pre_provisioned_reenable」，重新啟用零接觸註冊機制。注意：從這個狀態開始，裝置可取消佈建。
  • pre_provisioned_reenable：裝置已由原始設備製造商 (OEM) 預先佈建。處於此狀態的裝置可使用零接觸註冊機制。
deprovisionReason

string

只有在動作是解除配置時才會使用。在解除配置動作中，這是必填欄位。

可接受的值如下：

  • different_model_replacement：如果您要將裝置升級或更換為較新型號的相同裝置，請使用此值。
  • retiring_device：如果您要轉售、捐贈或不再使用裝置，請使用此值。
  • same_model_replacement：如果裝置發生硬體問題，且已更換為同型號或維修供應商 / 製造商提供的同類型號替換品，請使用此值。
  • upgrade_transfer：如果您將在一年內用 Chromebook 取代 CloudReady 裝置，請使用這個值。