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 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string (Duration format)

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

持續時間以秒為單位，最多 9 個小數位數，結尾為「s」。範例："3.5s"。

string

擁有裝置的使用者資源名稱，格式為 enterprises/{enterpriseId}/users/{userId}。伺服器會根據傳送指令的裝置自動產生這組 ID。

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》。