此页面由 Cloud Translation API 翻译。

Method: chromeosdevices.action

请改用 BatchChangeChromeOsDeviceStatus。执行会影响 ChromeOS 设备的操作。这包括停用、停用和重新启用设备。

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` 也会作为“用户”资源的一部分返回。
`resourceId`	`string` 设备的唯一 ID。系统会在 chromeosdevices.list 方法的响应中返回 `resourceId`。

customerId

string

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

resourceId

string

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

请求正文

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

响应正文

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

授权范围

需要以下 OAuth 范围：

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

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

ChromeOsDeviceAction

与 ChromeOS 设备状态更新相关的数据。

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`：如果您要在一年内将 Cloud Ready 设备更换为 Chromebook，请使用此选项。

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：如果您要在一年内将 Cloud Ready 设备更换为 Chromebook，请使用此选项。