Method: customer.devices.chromeos.issueCommand

向裝置發出指令，讓裝置執行指令。

HTTP 要求

POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}:issueCommand

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
customerId

string

不可變動。Google Workspace 帳戶 ID。
deviceId

string

不可變動。Chrome OS 裝置的 ID。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "commandType": enum (CommandType),
  "payload": string
}
欄位
commandType

enum (CommandType)

指令的類型。
payload

string

指令的酬載，只會在指令支援的情況下提供。下列指令支援新增酬載：

  • SET_VOLUME：酬載是字串化的 JSON 物件，格式為：{ "volume": 50 }。磁碟區必須是 [0,100] 這個範圍內的整數。
  • DEVICE_START_CRD_SESSION：酬載是選擇性的字串 JSON 物件，格式為：{ "ackedUserPresence": true }。ackedUserPresence 為布林值。根據預設，ackedUserPresence 設為 false。如要為使用中的裝置啟動 Chrome 遠端桌面工作階段，請將 ackedUserPresence 設為 true。
  • REBOOT：酬載是字串化的 JSON 物件，格式為：{ "user_session_delay_seconds": 300 }。延遲時間必須介於 [0, 300] 之間。
  • FETCH_SUPPORT_PACKET：Payload 是選擇性字串化的 JSON 物件 (一種經字串化的 JSON 物件，格式為：{"supportPacketDetails":{ "issueCaseId":—"supportPacketDetails":{ "issueCaseId": optional_support_case_id_string, "issueDescription": optional_issue_description_string, "requestedDataCollectors": "requestedDataCollectors":：[<comma-分隔的 data_collector_enums 整數階層 ID> 的 data_collector_enums 整數)，且

    詳情請參閱說明文章。

回應主體

發出指令的回應。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "commandId": string
}
欄位
commandId

string (int64 format)

發出指令的專屬 ID，用於擷取指令狀態。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/admin.directory.device.chromeos

詳情請參閱授權指南。