REST Resource: customer.devices.chromeos.commands

Recurso: DirectoryChromeosdevicesCommand

Informações sobre um comando emitido para um dispositivo.

Representação JSON 
{
  "commandId": string,
  "type": enum (CommandType),
  "issueTime": string,
  "state": enum (State),
  "commandExpireTime": string,
  "commandResult": {
    object (DirectoryChromeosdevicesCommandResult)
  },
  "payload": string
}
Campos
commandId

string (int64 format)

ID exclusivo de um comando do dispositivo.
type

enum (CommandType)

O tipo do comando.
issueTime

string (Timestamp format)

O carimbo de data/hora em que o comando foi emitido pelo administrador.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
state

enum (State)

Indica o estado do comando.
commandExpireTime

string (Timestamp format)

O horário de expiração do comando. Se o dispositivo não executar o comando nesse período, ele vai expirar.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
commandResult

object (DirectoryChromeosdevicesCommandResult)

O resultado da execução do comando.
payload

string

O payload especificado pelo comando, se houver.

CommandType

Estabelece o tipo de comando que o dispositivo precisa executar.

Enums
COMMAND_TYPE_UNSPECIFIED O tipo de comando não foi especificado.
REBOOT Reinicialize o dispositivo. Pode ser emitido para dispositivos de quiosque e sessões de visitante gerenciadas, além de dispositivos comuns com o ChromeOS versão 113 ou mais recente.
TAKE_A_SCREENSHOT Faça uma captura de tela do dispositivo. Disponível apenas se o dispositivo estiver no modo quiosque.
SET_VOLUME Defina o volume do dispositivo. Só pode ser emitido para dispositivos em quiosque e sessões de visitante gerenciadas.
WIPE_USERS Exclua todos os usuários do dispositivo. A execução desse comando no dispositivo remove todos os dados do perfil do usuário, mas mantém a política do dispositivo e a inscrição.
REMOTE_POWERWASH Limpa o dispositivo com uma lavagem completa. A execução desse comando no dispositivo remove todos os dados, incluindo políticas do usuário, políticas do dispositivo e políticas de registro. Aviso: a configuração original do dispositivo será restaurada sem o registro, a menos que ele esteja sujeito ao registro forçado ou automático. Use com cuidado, porque essa ação é irreversível.
DEVICE_START_CRD_SESSION Inicia uma sessão da Área de trabalho remota do Google Chrome.
CAPTURE_LOGS Capture os registros do sistema de um dispositivo de quiosque. Os registros podem ser baixados no link downloadUrl presente no campo deviceFiles de chromeosdevices.
FETCH_CRD_AVAILABILITY_INFO Busca informações que determinam a disponibilidade da Área de trabalho remota do Chrome no dispositivo.
FETCH_SUPPORT_PACKET Buscar pacote de suporte de um dispositivo remotamente. O pacote de suporte é um arquivo ZIP que contém vários registros do sistema e dados de depuração de um dispositivo ChromeOS. O pacote de suporte pode ser baixado no link downloadURL presente no campo deviceFiles de chromeosdevices.

Estado

Representa o estado do comando emitido.

Enums
STATE_UNSPECIFIED O status do comando não foi especificado.
PENDING Um comando não expirado que ainda não foi enviado ao cliente.
EXPIRED O comando não foi executado pelo cliente no tempo esperado.
CANCELLED O comando é cancelado pelo administrador enquanto está em PENDING.
SENT_TO_CLIENT O comando foi enviado ao cliente.
ACKED_BY_CLIENT O cliente respondeu que recebeu o comando.
EXECUTED_BY_CLIENT O cliente executou (ou não) o comando.

DirectoryChromeosdevicesCommandResult

O resultado da execução de um comando.

Representação JSON 
{
  "result": enum (CommandResultType),
  "executeTime": string,
  "errorMessage": string,
  "commandResultPayload": string
}
Campos
result

enum (CommandResultType)

O resultado do comando.
executeTime

string (Timestamp format)

O horário em que o comando foi executado ou não.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
errorMessage

string

A mensagem de erro com uma breve explicação sobre por que o comando falhou. Só está presente se o comando falhou.
commandResultPayload

string

O payload do resultado do comando. Os comandos a seguir respondem com um payload:

  • DEVICE_START_CRD_SESSION: o payload é um objeto JSON convertido em string no formato: { "url": url }. O URL fornece um link para a sessão do Chrome Remote Desktop.

CommandResultType

O tipo do resultado do comando.

Enums
COMMAND_RESULT_TYPE_UNSPECIFIED O resultado do comando não foi especificado.
IGNORED O comando foi ignorado como obsoleto.
FAILURE O comando não foi executado.
SUCCESS O comando foi executado.

Métodos

get

 Recebe dados de comando de um comando específico emitido para o dispositivo.