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

詳情請參閱授權指南。

Chrome OS 裝置動作

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

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

欄位

欄位
`action`	`string` chromedevices.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 的裝置更換為 Chromebook，請使用這個選項。

action

string

chromedevices.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 的裝置更換為 Chromebook，請使用這個選項。