Method: customer.devices.chromeos.issueCommand

Issues a command for the device to execute.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
customerId

string

Immutable. ID of the Google Workspace account.

deviceId

string

Immutable. ID of Chrome OS Device.

Request body

The request body contains data with the following structure:

JSON representation
{
  "commandType": enum (CommandType),
  "payload": string
}
Fields
commandType

enum (CommandType)

The type of command.

payload

string

The payload for the command, provide it only if command supports it. The following commands support adding payload:

  • SET_VOLUME: Payload is a stringified JSON object in the form: { "volume": 50 }. The volume has to be an integer in the range [0,100].
  • DEVICE_START_CRD_SESSION: Payload is optionally a stringified JSON object in the form: { "ackedUserPresence": true }. ackedUserPresence is a boolean. By default, ackedUserPresence is set to false. To start a Chrome Remote Desktop session for an active device, set ackedUserPresence to true.
  • REBOOT: Payload is a stringified JSON object in the form: { "user_session_delay_seconds": 300 }. The delay has to be in the range [0, 300].
  • FETCH_SUPPORT_PACKET: Payload is optionally a stringified JSON object in the form: {"supportPacketDetails":{ "issueCaseId": optional_support_case_id_string, "issueDescription": optional_issue_description_string, "requestedDataCollectors": [<comma-separated list of data_collector_enums integer values>]}}
    The list of available data_collector_enums are as following: Chrome System Information (1), Crash IDs (2), Memory Details (3), UI Hierarchy (4), Additional ChromeOS Platform Logs (5), Device Event (6), Intel WiFi NICs Debug Dump (7), Touch Events (8), Lacros (9), Lacros System Information (10), ChromeOS Flex Logs (11), DBus Details (12), ChromeOS Network Routes (13), ChromeOS Shill (Connection Manager) Logs (14), Policies (15), ChromeOS System State and Logs (16), ChromeOS System Logs (17), ChromeOS Chrome User Logs (18), ChromeOS Bluetooth (19), ChromeOS Connected Input Devices (20), ChromeOS Traffic Counters (21), ChromeOS Virtual Keyboard (22), ChromeOS Network Health (23).
    See more details in help article.

Response body

A response for issuing a command.

If successful, the response body contains data with the following structure:

JSON representation
{
  "commandId": string
}
Fields
commandId

string (int64 format)

The unique ID of the issued command, used to retrieve the command status.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the Authorization guide.