Method: chromeosdevices.action

執行會影響 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`。

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

詳情請參閱 OAuth 2.0 總覽。

Chrome OS 裝置動作

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

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

欄位

欄位
`action`	`string` chromeosdevices.action 在 Chrome OS 裝置上執行。可接受的值如下： `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 就緒的裝置替換為 Chromebook。

action

string

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

可接受的值如下：

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 就緒的裝置替換為 Chromebook。