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