Method: chromeosdevices.action

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

HTTP 要求

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

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

路徑參數

參數
customerId

string

客戶 Google Workspace 帳戶的專屬 ID。身為帳戶管理員,您也可以使用 my_customer 別名來代表帳戶的 customerIdcustomerId 也會做為使用者資源的一部分傳回。

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 裝置,請使用這個值。