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

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

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

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