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 別名代表帳戶的 customerId。customerId 也會做為使用者資源的一部分傳回。
resourceId	string 裝置的專屬 ID。系統會透過 chromeosdevices.list 方法的回應傳回 resourceId。

要求主體

要求主體包含 ChromeOsDeviceAction 的例項。

回應主體

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱授權指南。

ChromeOsDeviceAction

關於 ChromeOS 裝置狀態更新的相關資料。

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

欄位
action	string 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：如果您在一年內將 Cloud Ready 裝置替換為 Chromebook，請採用此做法。