本頁面由 Cloud Translation API 翻譯而成。

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`。

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` chromeosdevices.action。可接受的值為： `deprovision`. `disable`：如果您認為貴機構的裝置遺失或遭竊，可以停用裝置，防止他人使用裝置。停用 Chrome 裝置後，所有使用者都會看到開啟 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，請使用這個選項。

action

string

chromeosdevices.action。

可接受的值為：

deprovision.
disable：如果您認為貴機構的裝置遺失或遭竊，可以停用裝置，防止他人使用裝置。停用 Chrome 裝置後，所有使用者都會看到開啟 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，請使用這個選項。