Method: chromeosdevices.action

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

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数

参数
`customerId`	`string` 客户的 Google Workspace 帐号的唯一 ID。作为帐号管理员，您还可以使用 `my_customer` 别名来表示您帐号的 `customerId`。`customerId` 还会作为 Users 资源的一部分返回。
`resourceId`	`string` 设备的唯一 ID。chromeosdevices.list 方法返回的响应中会返回 `resourceId`。

customerId

string

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

resourceId

string

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

请求正文

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

响应正文

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

授权范围

需要以下 OAuth 作用域：

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

如需了解详情，请参阅授权指南。

Chrome 操作系统设备操作

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

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

字段

字段
`action`	`string` 可在 Chrome 操作系统设备上执行 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 替换云端设备，请使用此类型。

action

string

可在 Chrome 操作系统设备上执行 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 替换云端设备，请使用此类型。