Method: enterprises.devices.issueCommand

string

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

enum (CommandType)

命令的类型。

string (Timestamp format)

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

采用 RFC 3339 标准，生成的输出将始终在末尾带 Z，并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

string (Duration format)

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

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

string

拥有相应设备的用户的资源名称，格式为 enterprises/{enterpriseId}/users/{userId}。这是由服务器根据命令发送到的设备自动生成的。

enum (CommandErrorCode)

如果命令失败，则会显示说明失败原因的错误代码。如果命令被调用方取消，则不会设置此值。对于有关命令错误的推理，请按以下顺序优先选择字段（最优先选择的字段排在最前面）：1. 特定于命令的字段，例如 clearAppsDataStatus、startLostModeStatus 或类似字段（如果存在）。2. 此字段（如果已设置）。3. 封装命令的 Operation 中的通用 error 字段。

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 (AddEsimParams)

可选。用于向设备添加 eSIM 卡配置文件的 ADD_ESIM 命令的参数。如果设置了此参数，建议不要设置 type。在这种情况下，服务器会自动将其设置为 ADD_ESIM。也可以明确将 type 设置为 ADD_ESIM。

object (RemoveEsimParams)

可选。用于从设备中移除 eSIM 卡配置文件的 REMOVE_ESIM 命令的参数。如果设置了此参数，建议不要设置 type。在这种情况下，服务器会自动将其设置为 REMOVE_ESIM。也可以明确将 type 设置为 REMOVE_ESIM。

object (RequestDeviceInfoParams)

可选。用于获取设备相关信息的 REQUEST_DEVICE_INFO 命令的参数。如果设置了此参数，建议不要设置 type。在这种情况下，服务器会自动将其设置为 REQUEST_DEVICE_INFO。也可以明确将 type 设置为 REQUEST_DEVICE_INFO。

object (WipeParams)

可选。用于擦除设备的 WIPE 命令的参数。如果设置了此参数，建议不要设置 type。在这种情况下，服务器会自动将其设置为 WIPE。也可以明确将 type 设置为 WIPE。

object (ClearAppsDataStatus)

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

object (StartLostModeStatus)

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

object (StopLostModeStatus)

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

object (EsimCommandStatus)

仅限输出。ADD_ESIM 或 REMOVE_ESIM 命令的状态。

object (RequestDeviceInfoStatus)

仅限输出。REQUEST_DEVICE_INFO 命令的状态。

string

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

object (UserFacingMessage)

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

object (UserFacingMessage)

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

string

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

object (UserFacingMessage)

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

object (UserFacingMessage)

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

string

必需。eSIM 卡配置文件的激活码。

enum (ActivationState)

必需。下载 eSIM 卡配置文件后的激活状态。

string

必需。要删除的 eSIM 卡配置文件的 ICC ID。

enum (DeviceInfo)

必需。要请求的设备信息类型。

enum (WipeDataFlag)

可选。用于确定要清除哪些数据的标志。

object (UserFacingMessage)

可选。在擦除个人设备上的工作资料之前向用户显示的简短消息。这不会影响公司自有设备。消息长度上限为 200 个字符。

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

每个应用的结果，即从软件包名称到相应清除结果的映射。

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

enum (ClearingResult)

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

enum (Status)

状态。请参阅 StartLostModeStatus。

enum (Status)

状态。请参阅 StopLostModeStatus。

enum (Status)

仅限输出。ADD_ESIM 或 REMOVE_ESIM 命令的状态。

object (EsimInfo)

仅限输出。有关已添加或移除的 eSIM 卡的信息。仅当 eSIM 卡操作 status 为 SUCCESS 时，系统才会填充此字段。

object (InternalErrorDetails)

仅限输出。如果 status 设置为 INTERNAL_ERROR，则为错误的详细信息。

string (int64 format)

仅限输出。操作代码的整数表示形式，如此处所述。如需了解详情，请参阅 operationCodeDetail。

string (int64 format)

仅限输出。错误代码的整数表示形式，如此处所示。另请参阅 OPERATION_SMDX_SUBJECT_REASON_CODE。如需了解详情，请参阅 errorCodeDetail。

enum (OperationCodeDetail)

仅限输出。与 operationCode 对应的操作代码详细信息。

enum (ErrorCodeDetail)

仅限输出。与 errorCode 对应的错误代码详细信息。

string

仅限输出。eSIM 卡的 ICC ID。

enum (Status)

仅限输出。REQUEST_DEVICE_INFO 命令的状态。

object (EidInfo)

与设备的 EID 相关的信息。

object (Eid)

仅限输出。每个 eUICC 芯片的 EID 信息。

string

仅限输出。EID