Method: enterprises.devices.issueCommand

string

设备的名称，格式为 enterprises/{enterpriseId}/devices/{deviceId}。

{
  "type": enum (CommandType),
  "createTime": string,
  "duration": string,
  "userName": string,
  "errorCode": enum (CommandErrorCode),
  "newPassword": string,
  "resetPasswordFlags": [
    enum (ResetPasswordFlag)
  ],

  // Union field params can be only one of the following:
  "clearAppsDataParams": {
    object (ClearAppsDataParams)
  },
  "startLostModeParams": {
    object (StartLostModeParams)
  },
  "stopLostModeParams": {
    object (StopLostModeParams)
  }
  // End of list of possible types for union field params.

  // Union field status can be only one of the following:
  "clearAppsDataStatus": {
    object (ClearAppsDataStatus)
  },
  "startLostModeStatus": {
    object (StartLostModeStatus)
  },
  "stopLostModeStatus": {
    object (StopLostModeStatus)
  }
  // End of list of possible types for union field status.
}

enum (CommandType)

命令的类型。

string (Timestamp format)

命令创建时的时间戳。时间戳由服务器自动生成。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string (Duration format)

命令有效的时长。如果设备在此期间未执行该命令，该命令将会过期。如果未指定，默认时长为 10 分钟。没有时长上限。

该时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。

string

设备所有者用户的资源名称，格式为 enterprises/{enterpriseId}/users/{userId}。此值由服务器根据命令要发送到的设备自动生成。

enum (CommandErrorCode)

如果命令失败，则包含一个错误代码来说明失败原因。当调用方取消命令时，系统不会设置此值。

string

对于类型为 RESET_PASSWORD 的命令，可选择指定新密码。注意：对于 Android 14 设备，如果新密码是数字，则必须至少包含 6 个字符。否则，该命令将失败并显示 INVALID_VALUE。

enum (ResetPasswordFlag)

对于类型为 RESET_PASSWORD 的命令，可选指定标志。

object (ClearAppsDataParams)

用于从设备中清除指定应用数据的 CLEAR_APP_DATA 命令的参数。请参阅 ClearAppsDataParams。如果设置了此值，则建议不要设置 type。在这种情况下，服务器会自动将其设置为 CLEAR_APP_DATA。您也可以明确将 type 设置为 CLEAR_APP_DATA。

object (StartLostModeParams)

用于将设备置于丢失模式的 START_LOST_MODE 命令的参数。请参阅 StartLostModeParams。如果设置了此值，则建议不要设置 type。在这种情况下，服务器会自动将其设置为 START_LOST_MODE。您也可以明确将 type 设置为 START_LOST_MODE。

object (StopLostModeParams)

用于让设备退出丢失模式的 STOP_LOST_MODE 命令的参数。请参阅 StopLostModeParams。如果设置了此值，则建议不要设置 type。在这种情况下，服务器会自动将其设置为 STOP_LOST_MODE。您也可以明确将 type 设置为 STOP_LOST_MODE。

object (ClearAppsDataStatus)

仅限输出。用于从设备中清除指定应用数据的 CLEAR_APP_DATA 命令的状态。请参阅ClearAppsDataStatus。

object (StartLostModeStatus)

仅限输出。用于将设备置于丢失模式的 START_LOST_MODE 命令的状态。请参阅StartLostModeStatus。

object (StopLostModeStatus)

仅限输出。用于让设备退出丢失模式的 STOP_LOST_MODE 命令的状态。请参阅StopLostModeStatus。

{
  "packageNames": [
    string
  ]
}

string

执行该命令时将清除其数据的应用的软件包名称。

{
  "lostMessage": {
    object (UserFacingMessage)
  },
  "lostPhoneNumber": {
    object (UserFacingMessage)
  },
  "lostEmailAddress": string,
  "lostStreetAddress": {
    object (UserFacingMessage)
  },
  "lostOrganization": {
    object (UserFacingMessage)
  }
}

object (UserFacingMessage)

设备处于丢失模式时向用户显示的消息。

object (UserFacingMessage)

当设备处于丢失模式且用户点按“致电所有者”按钮时，系统会拨打的电话号码。

string

设备处于丢失模式时向用户显示的电子邮件地址。

object (UserFacingMessage)

设备处于丢失模式时向用户显示的街道地址。

object (UserFacingMessage)

设备处于丢失模式时向用户显示的组织名称。

{
  "results": {
    string: {
      object (PerAppResult)
    },
    ...
  }
}

map (key: string, value: object (PerAppResult))

按应用的结果，即软件包名称与相应清除结果之间的映射。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

{
  "clearingResult": enum (ClearingResult)
}

enum (ClearingResult)

尝试清除单个应用数据的结果。

{
  "status": enum (Status)
}

enum (Status)

状态。请参阅 StartLostModeStatus。

{
  "status": enum (Status)
}

enum (Status)

状态。请参阅 StopLostModeStatus。