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 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.
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.
[null,null,["Última atualização 2024-11-09 UTC."],[[["This API (`customer.devices.chromeos/action`) is deprecated and `BatchChangeChromeOsDeviceStatus` should be used instead."],["It allows administrators to manage the status of Chrome OS devices, including deprovisioning, disabling, and re-enabling."],["Deprovisioning removes device management, disabling prevents usage (ideal for lost/stolen devices), and re-enabling restores device access."],["Before re-enrollment, deprovisioned devices require wiping, and re-enabling a device consumes a device license."]]],[]]