Method: chromeosdevices.action

Use BatchChangeChromeOsDeviceStatus. Realiza uma ação que afeta um dispositivo Chrome OS. Isso inclui o desprovisionamento, a desativação e a reativação de 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 sua conta. O customerId também é retornado como parte do recurso de usuários.

resourceId

string

O ID exclusivo do dispositivo. Os resourceIds são retornados 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 do status de um dispositivo ChromeOS.

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

string

chromeosdevices.action a ser realizada no dispositivo ChromeOS.

Os valores aceitáveis são:

  • deprovision: remova um dispositivo do gerenciamento que não está mais ativo, está sendo revendido ou está sendo enviado para devolução / reparo. Use a ação de desprovisionamento para desvincular o dispositivo 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, tudo o que o usuário pode ver ao ligá-lo é uma tela informando que ele foi desativado e os dados de contato para devolução do dispositivo.
  • reenable: reativar um dispositivo desativado quando ele for encontrado ou devolvido. Você também pode usar esse recurso se marcar um dispositivo Chrome como desativado acidentalmente.
  • 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_provisioned_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, este 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ê quiser revender, doar ou remover permanentemente o dispositivo.
  • same_model_replacement: use se um problema de hardware foi encontrado em um dispositivo e ele está sendo substituído pelo mesmo modelo ou por um modelo semelhante de um fornecedor de reparo / fabricante.
  • upgrade_transfer: use se você estiver substituindo seus dispositivos Cloud Ready por Chromebooks em até um ano.