Method: customer.devices.chromeos.issueCommand

Emite un comando para que el dispositivo lo ejecute.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
customerId

string

Inmutable. ID de la cuenta de Google Workspace.

deviceId

string

Inmutable. ID del dispositivo con ChromeOS.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON
{
  "commandType": enum (CommandType),
  "payload": string
}
Campos
commandType

enum (CommandType)

Es el tipo de comando.

payload

string

Es la carga útil para el comando. Proporcionala solo si el comando la admite. Los siguientes comandos permiten agregar una carga útil:

  • SET_VOLUME: La carga útil es un objeto JSON en cadena con el formato: { "volume": 50 }. El volumen debe ser un número entero dentro del rango [0,100].
  • DEVICE_START_CRD_SESSION: La carga útil es, de forma opcional, un objeto JSON en cadena con el formato { "ackedUserPresence": true }. ackedUserPresence es un valor booleano. De forma predeterminada, ackedUserPresence se configura como false. Para iniciar una sesión de Escritorio remoto de Chrome para un dispositivo activo, establece ackedUserPresence en true.
  • REBOOT: La carga útil es un objeto JSON en cadena con el formato: { "user_session_delay_seconds": 300 }. La demora debe estar en el rango [0, 300].
  • FETCH_SUPPORT_PACKET: Opcionalmente, la carga útil es un objeto JSON en cadena con el formato: {"supportPacketDetails":{ "issueCaseId":optional_support_case_id_string, "issueDescription":optional_issue_description_string, "requestedDataRecopiladores": [<comma-separate list of data_collector_enums integer values>]}}
    La lista de registros de la red de ChromeOS 1 ChromeOS (1) ChromeOS, los registros de la red de ChromeOS (2) ChromeOS y los registros de la red de ChromeOS (2), la lista de registros de ChromeOS de ChromeOS (2) ChromeOS, y los registros de la red ChromeOS (1), ChromeOS 1 ChromeOS, los registros de la red de ChromeOS (2), la lista de registros de la red de ChromeOS (1), ChromeOS, 1 ChromeOS, ladata_collector_enums
    Obtén más detalles en este artículo de ayuda.

Cuerpo de la respuesta

Una respuesta para emitir un comando.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON
{
  "commandId": string
}
Campos
commandId

string (int64 format)

El ID único del comando emitido, que se usa para recuperar el estado del comando.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la guía de autorización.