Method: chromeosdevices.action

请改用 BatchChangeChromeOsDeviceStatus。执行会影响 Chrome 操作系统设备的操作。包括取消配置、停用和重新启用设备。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
customerId

string

客户的 Google Workspace 帐号的唯一 ID。作为帐号管理员,您还可以使用 my_customer 别名来表示您帐号的 customerIdcustomerId 也会作为 Users 资源的一部分返回。

resourceId

string

设备的唯一 ID。chromeosdevices.list 方法的响应中会返回 resourceId

请求正文

请求正文包含一个 ChromeOsDeviceAction 实例。

响应正文

如果成功,则响应为通用 HTTP 响应,其格式由方法定义。

授权范围

需要以下 OAuth 作用域:

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

有关详情,请参阅授权指南

ChromeOsDeviceAction

Chrome 操作系统设备状态更新的相关数据。

JSON 表示法
{
  "action": string,
  "deprovisionReason": string
}
字段
action

string

为 ChromeOS 设备执行 chromeosdevices.action。

可接受的值为:

  • deprovision:如果不再有效、转售或正提请退货 / 维修,请将相应设备从管理中心中移除,可通过执行取消配置操作解除其与管理的关联。
  • disable:如果您认为贵组织中有设备丢失或被盗,可以停用该设备,这样其他人就无法使用了。停用设备后,所有用户都可以在开启 Chrome 设备时看到一个屏幕,告知他们该设备已停用,以及设备归还地点所需的联系信息。
  • reenable:如果发现设备丢失或丢失的设备被退回,则重新启用已停用的设备。如果您不小心将 Chrome 设备标记为已停用,也可以使用此功能。
  • pre_provisioned_disable:无法注册的预配置设备。管理员可以将状态更改为“pre_provisioned_reenable”以重新启用设备,以允许“零触摸注册”。注意:从此状态下,可以取消配置设备。
  • pre_provisioned_reenable:设备由 OEM 预配置。处于此状态的设备符合零触摸注册的条件。
deprovisionReason

string

仅在取消配置操作时使用。执行取消配置操作时,此字段为必填字段。

可接受的值为:

  • different_model_replacement:如果您要将设备升级或更换为该设备的新型号,请使用此选项。
  • retiring_device:如果您要转售、捐献或永久停止使用设备,请使用此选项。
  • same_model_replacement:如果设备遇到硬件问题,且已替换为维修供应商 / 制造商提供的相同型号或类似型号的替换设备,请使用此选项。
  • upgrade_transfer:如果您要在一年内用 Chromebook 替换您的云端设备,请使用此选项。