本頁面由 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

關於 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，請採用此做法。

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，請採用此做法。