Method: customer.devices.chromeos.issueCommand

Emite um comando para o dispositivo executar.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
customerId

string

Imutável. ID da conta do Google Workspace.

deviceId

string

Imutável. ID do dispositivo ChromeOS.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "commandType": enum (CommandType),
  "payload": string
}
Campos
commandType

enum (CommandType)

O tipo de comando.

payload

string

O payload do comando, forneça apenas se o comando for compatível. Os comandos a seguir são compatíveis com a adição de payload:

  • SET_VOLUME: o payload é um objeto JSON convertido em string no formato: { "volume": 50 }. O volume precisa ser um número inteiro no intervalo [0,100].
  • DEVICE_START_CRD_SESSION: o payload é opcionalmente um objeto JSON em string no formato: { "ackedUserPresence": true, "crdSessionType": string }. ackedUserPresence é um booleano. Por padrão, ackedUserPresence é definido como false. Para iniciar uma sessão da Área de trabalho remota do Google Chrome em um dispositivo ativo, defina ackedUserPresence como true. crdSessionType só pode selecionar os valores private, que concedem ao administrador remoto o controle exclusivo do dispositivo ChromeOS, ou shared, que permite que o administrador e o usuário local compartilhem o controle do dispositivo ChromeOS. Se não for definido, crdSessionType será usado como padrão para shared.
  • REBOOT: o payload é um objeto JSON convertido em string no formato: { "user_session_delay_seconds": 300 }. O user_session_delay_seconds é a quantidade de segundos que o dispositivo vai esperar antes de ser reinicializado se um usuário estiver conectado. Precisa ser um número inteiro no intervalo [0,300]. Quando o payload não está presente para a reinicialização, o padrão é 0 de atraso. Observação: isso só se aplica se um usuário real estiver conectado, incluindo um visitante. Se o dispositivo estiver na tela de login ou no modo quiosque, o valor não será respeitado, e o dispositivo será reinicializado imediatamente.
  • FETCH_SUPPORT_PACKET: o payload é opcionalmente um objeto JSON stringificado no formato: {"supportPacketDetails":{ "issueCaseId": optional_support_case_id_string, "issueDescription": optional_issue_description_string, "requestedDataCollectors": [<comma-separated list of data_collector_enums integer values>]}}
    A lista de data_collector_enums disponíveis é a seguinte: informações do sistema do Chrome (1), IDs de falha (2), detalhes de memória (3), hierarquia da interface (4), registros adicionais da plataforma ChromeOS (5), evento do dispositivo (6), descarte de depuração de NICs de Wi-Fi Intel (7), eventos de toque (8), Lacros (9), informações do sistema Lacros (10), registros do ChromeOS Flex (11), detalhes do DBus (12), rotas de rede do ChromeOS (13), registros do ChromeOS Shill (gerenciador de conexões) (14), políticas (15), estado e registros do sistema ChromeOS (16), registros do sistema ChromeOS (17), registros do usuário do ChromeOS Chrome (18), Bluetooth do ChromeOS (19), dispositivos de entrada conectados do ChromeOS (20), contadores de tráfego do ChromeOS (21), teclado virtual do ChromeOS (22), integridade de rede do ChromeOS (23).
    Confira mais detalhes no artigo de ajuda.

Corpo da resposta

Uma resposta para emitir um comando.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "commandId": string
}
Campos
commandId

string (int64 format)

O ID exclusivo do comando emitido, usado para recuperar o status do comando.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte o guia de autorização.