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:载荷是形式为 { "user_session_delay_seconds": 300 } 的字符串化 JSON 对象。延迟时间必须在 [0, 300] 范围内。
  • FETCH_SUPPORT_PACKET:载荷 [载荷] (ChromeOS 系统日志 [Cron 1] 和 [C 代表 1] 日志)、字符串 2 (ChromeOS 1 和 1 和 1 [ChromeOS 1] 日志),可采用字符串化形式:{"supportPacketDetails":{ "issueCaseId": optional_support_case_id_string, "issueDescription": optional_issue_description_string, "requestedDataCollectors": [<ChromeOS 平台 ID [ChromeOS 平台 ID>]]}}。可用的 data_collector_enums (ChromeOS 平台信息 [2] 和 Route Details 列表如下]:Chrome 系统信息 (2)、路线 3data_collector_enums

    如需了解详情,请参阅帮助文章

响应正文

对发出命令的响应。

如果成功,响应正文将包含结构如下的数据:

JSON 表示法
{
  "commandId": string
}
字段
commandId

string (int64 format)

已发出的命令的唯一 ID,用于检索命令状态。

授权范围

需要以下 OAuth 作用域:

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

有关详情,请参阅授权指南