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)

指令的有效期限。如果裝置在這段時間內未執行指令，指令就會過期。如未指定，預設時間長度為十分鐘。沒有時間長度上限。

時間長度以秒為單位，最多可有 9 個小數位數，並應以「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)

(選用步驟) ADD_ESIM 指令的參數，可將 eSIM 卡設定檔新增至裝置。如果設定這項政策，建議不要設定 type。在這種情況下，伺服器會自動將其設為 ADD_ESIM。您也可以明確將 type 設為 ADD_ESIM。

object (RemoveEsimParams)

(選用步驟) 使用 REMOVE_ESIM 指令從裝置移除 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