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

詳情請參閱授權指南