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 Sistema operativo Chrome.

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; proporciónala 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 siguiente formato: { "volume": 50 }. El volumen debe ser un número entero dentro del rango [0,100].
  • DEVICE_START_CRD_SESSION: De manera opcional, la carga útil es un objeto JSON en cadena con el siguiente formato: { "ackedUserPresence": true }. 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.
  • REBOOT: La carga útil es un objeto JSON en cadena con el siguiente formato: { "user_session_delay_seconds": 300 }. El retraso debe estar en el rango [0, 300].
  • FETCH_SUPPORT_PACKETdata_collector_enumsdata_collector_enums

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

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