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. Es el ID del dispositivo 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

La carga útil del comando. Proporciona esta información solo si el comando la admite. Los siguientes comandos admiten la adición de carga útil:

  • SET_VOLUME: La carga útil es un objeto JSON convertido en cadena con el formato: { "volume": 50 }. El volumen debe ser un número entero en el rango [0,100].
  • DEVICE_START_CRD_SESSION: De manera opcional, la carga útil es un objeto JSON convertido en cadena con el formato: { "ackedUserPresence": true, "crdSessionType": cadena }. ackedUserPresence es un valor booleano. De forma predeterminada, ackedUserPresence se configura como false. Para iniciar una sesión del Escritorio remoto de Chrome en un dispositivo activo, establece ackedUserPresence en true. crdSessionType solo puede seleccionar entre los valores private (que otorga al administrador remoto el control exclusivo del dispositivo ChromeOS) o shared (que permite que el administrador y el usuario local compartan el control del dispositivo ChromeOS). Si no se establece, el valor predeterminado de crdSessionType es shared.
  • REBOOT: La carga útil es un objeto JSON con formato de cadena con el formato: { "user_session_delay_seconds": 300 }. user_session_delay_seconds es la cantidad de segundos que se deben esperar antes de reiniciar el dispositivo si un usuario accedió. Debe ser un número entero en el rango [0,300]. Cuando no hay carga útil para el reinicio, el retraso predeterminado es de 0. Nota: Esto solo se aplica si un usuario real accedió, incluido un invitado. Si el dispositivo está en la pantalla de acceso o en modo kiosco, no se respeta el valor y el dispositivo se reinicia de inmediato.
  • FETCH_SUPPORT_PACKET: De manera opcional, la carga útil es un objeto JSON con formato de cadena con el siguiente formato: {"supportPacketDetails":{ "issueCaseId": optional_support_case_id_string, "issueDescription": optional_issue_description_string, "requestedDataCollectors": [<comma-separated list of data_collector_enums integer values>]}}
    La lista de data_collector_enums disponibles es la siguiente: Información del sistema de Chrome (1), IDs de falla (2), Detalles de la memoria (3), Jerarquía de la IU (4), Registros adicionales de la plataforma de ChromeOS (5), Evento del dispositivo (6), volcado de depuración de NIC de Wi-Fi Intel (7), Eventos táctiles (8), Lacros (9), Información del sistema de Lacros (10), Registros de Flex de ChromeOS (11), Detalles de DBus (12), Rutas de red de ChromeOS (13), Registros de ChromeOS Shill (administrador de conexiones) (14), Políticas (15), Estado y registros del sistema de ChromeOS (16), Registros del sistema de ChromeOS (17), Registros de usuarios de Chrome de ChromeOS (18), Bluetooth de ChromeOS (19), Dispositivos de entrada conectados de ChromeOS (20), Contadores de tráfico de ChromeOS (21), Teclado virtual de ChromeOS (22), Estado de la red de ChromeOS (23).
    Consulta más detalles en el artículo de ayuda.

Cuerpo de la respuesta

Es 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.