Method: chromeosdevices.action

Use BatchChangeChromeOsDeviceStatus. realiza uma ação que afeta um dispositivo Chrome OS. Isso inclui desprovisionar, desativar e reativar dispositivos.

Solicitação HTTP

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

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

Parâmetros de caminho

Parâmetros
customerId

string

O ID exclusivo da conta do Google Workspace do cliente. Como administrador da conta, você também pode usar o alias my_customer para representar o customerId da conta. O customerId também é retornado como parte do recurso Usuários.
resourceId

string

O ID exclusivo do dispositivo. As resourceIds são retornadas na resposta do método chromeosdevices.list.

Corpo da solicitação

O corpo da solicitação contém uma instância de ChromeOsDeviceAction.

Corpo da resposta

Se for bem-sucedida, a resposta será uma resposta HTTP genérica que tem o formato definido pelo método.

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.

ChromeOsDeviceAction

Dados sobre uma atualização no status de um dispositivo Chrome OS.

Representação JSON 
{
  "action": string,
  "deprovisionReason": string
}
Campos
action

string

chromeosdevices.action a ser realizado no dispositivo Chrome OS.

Os valores aceitáveis são:

  • deprovision: remova do gerenciamento um dispositivo que não está mais ativo, que está sendo revendido ou enviado para devolução / reparo. Use a ação de desprovisionamento para desvinculá-lo do gerenciamento.
  • disable: se você acredita que um dispositivo da sua organização foi perdido ou roubado, é possível desativá-lo para que ninguém mais possa usá-lo. Quando um dispositivo é desativado, ao ligar o dispositivo Chrome, os usuários só veem uma tela informando que ele foi desativado e os dados de contato desejados para a devolução do dispositivo.
  • reenable: reativar um dispositivo desativado quando um dispositivo perdido for encontrado ou devolvido. Você também pode usar esse recurso se marcar acidentalmente um dispositivo Chrome como desativado.
  • pre_provisioned_disable: um dispositivo pré-provisionado que não pode ser registrado. Um administrador pode reativar o dispositivo para permitir o registro sem toque mudando o status para "pre_provision_reenable". Observação: nesse estado, o dispositivo pode ser desprovisionado.
  • pre_provisioned_reenable: o dispositivo é pré-provisionado pelos OEMs. Os dispositivos nesse estado estão qualificados para o registro sem toque.
deprovisionReason

string

Usado apenas quando a ação é desprovisionar. Com a ação de desprovisionamento, esse campo é obrigatório.

Os valores aceitáveis são:

  • different_model_replacement: use se você estiver fazendo upgrade ou substituindo seu dispositivo por um modelo mais recente do mesmo dispositivo.
  • retiring_device: use se você estiver revendendo, doando ou removendo permanentemente o dispositivo.
  • same_model_replacement: use se um problema de hardware for encontrado em um dispositivo e ele estiver sendo substituído pelo mesmo modelo ou por um modelo semelhante de um fornecedor de assistência técnica / fabricante.
  • upgrade_transfer: use se você quiser substituir os dispositivos prontos para a nuvem por Chromebooks dentro de um ano.