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

不可變動。ChromeOS 裝置的 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：酬載是選用字串化的 JSON 物件，格式為：{"supportPacketDetails":{ "issueCaseId": optional_support_case_id_string, "issueDescription": optional_issue_description_string, "requestedDataCollectors" (data_collector_enums 的整數值 (1)、Chrome 系統偵錯記錄 1、ChromeOS 連線狀態 1)、ChromeOS 連線狀態 1、ChromeOS 網路訊號 1、ChromeOS 網路訊號 1、ChromeOS 網路訊號事件 (1)、ChromeOS 網路訊號 1、ChromeOS 網路訊號事件 1、ChromeOS 網路訊號事件 1、ChromeOS 網路訊號事件 1、ChromeOS 網路訊號事件 1、ChromeOS 網路訊號事件 1、ChromeOS 網路訊號事件 1」、「ChromeOS 網路狀態記錄 1」、「ChromeOS 連線狀態 1」、「ChromeOS 網路狀態記錄」和「ChromeOS 網路訊號事件 ID」。data_collector_enums

    詳情請參閱說明文章。

回應主體

發出指令的回應。

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

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

string (int64 format)

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱授權指南。