Method: enterprises.devices.issueCommand

string

Tên của thiết bị ở dạng 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)

Loại lệnh.

string (Timestamp format)

Dấu thời gian tạo lệnh. Dấu thời gian được máy chủ tạo tự động.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

string (Duration format)

Thời lượng hiệu lực của lệnh. Lệnh sẽ hết hạn nếu thiết bị không thực thi trong khoảng thời gian này. Khoảng thời gian mặc định nếu bạn không chỉ định là 10 phút. Không có thời lượng tối đa.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".

string

Tên tài nguyên của người dùng sở hữu thiết bị ở dạng enterprises/{enterpriseId}/users/{userId}. Mã này được máy chủ tạo tự động dựa trên thiết bị mà lệnh được gửi đến.

enum (CommandErrorCode)

Nếu lệnh không thành công, mã lỗi sẽ giải thích lý do không thành công. Giá trị này không được đặt khi lệnh bị phương thức gọi huỷ.

string

Đối với các lệnh thuộc loại RESET_PASSWORD, bạn có thể chỉ định mật khẩu mới (không bắt buộc). Lưu ý: Mật khẩu mới phải có độ dài tối thiểu là 6 ký tự nếu là mật khẩu số trong trường hợp thiết bị chạy Android 14. Nếu không, lệnh sẽ không thành công với INVALID_VALUE.

enum (ResetPasswordFlag)

Đối với các lệnh thuộc loại RESET_PASSWORD, bạn có thể chỉ định cờ (flag).

object (ClearAppsDataParams)

Các tham số cho lệnh CLEAR_APP_DATA để xoá dữ liệu của các ứng dụng đã chỉ định khỏi thiết bị. Vui lòng xem ClearAppsDataParams. Nếu bạn đặt thuộc tính này, bạn không nên đặt type. Trong trường hợp này, máy chủ sẽ tự động đặt giá trị này thành CLEAR_APP_DATA. Bạn cũng có thể đặt rõ ràng type thành CLEAR_APP_DATA.

object (StartLostModeParams)

Các tham số cho lệnh START_LOST_MODE để đưa thiết bị vào chế độ mất. Vui lòng xem StartLostModeParams. Nếu bạn đặt thuộc tính này, bạn không nên đặt type. Trong trường hợp này, máy chủ sẽ tự động đặt giá trị này thành START_LOST_MODE. Bạn cũng có thể đặt rõ ràng type thành START_LOST_MODE.

object (StopLostModeParams)

Các tham số cho lệnh STOP_LOST_MODE để đưa thiết bị ra khỏi chế độ thất lạc. Vui lòng xem StopLostModeParams. Nếu bạn đặt thuộc tính này, bạn không nên đặt type. Trong trường hợp này, máy chủ sẽ tự động đặt giá trị này thành STOP_LOST_MODE. Bạn cũng có thể đặt rõ ràng type thành STOP_LOST_MODE.

object (ClearAppsDataStatus)

Chỉ có đầu ra. Trạng thái của lệnh CLEAR_APP_DATA để xoá dữ liệu của các ứng dụng đã chỉ định khỏi thiết bị. Vui lòng xem ClearAppsDataStatus.

object (StartLostModeStatus)

Chỉ có đầu ra. Trạng thái của lệnh START_LOST_MODE để đặt thiết bị vào chế độ mất. Vui lòng xem StartLostModeStatus.

object (StopLostModeStatus)

Chỉ có đầu ra. Trạng thái của lệnh STOP_LOST_MODE để đưa thiết bị ra khỏi chế độ thất lạc. Vui lòng xem StopLostModeStatus.

{
  "packageNames": [
    string
  ]
}

string

Tên gói của các ứng dụng có dữ liệu sẽ bị xoá khi lệnh được thực thi.

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

object (UserFacingMessage)

Thông báo hiển thị cho người dùng khi thiết bị ở chế độ thất lạc.

object (UserFacingMessage)

Số điện thoại sẽ được gọi khi thiết bị ở chế độ mất và người dùng nhấn vào nút chủ sở hữu cuộc gọi.

string

Địa chỉ email hiển thị cho người dùng khi thiết bị ở chế độ thất lạc.

object (UserFacingMessage)

Địa chỉ đường phố hiển thị cho người dùng khi thiết bị ở chế độ thất lạc.

object (UserFacingMessage)

Tên tổ chức hiển thị cho người dùng khi thiết bị ở chế độ thất lạc.

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

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

Kết quả trên mỗi ứng dụng, một mối liên kết từ tên gói đến kết quả xoá tương ứng.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

{
  "clearingResult": enum (ClearingResult)
}

enum (ClearingResult)

Kết quả của một lần thử xoá dữ liệu của một ứng dụng.

{
  "status": enum (Status)
}

enum (Status)

Trạng thái. Vui lòng xem StartLostModeStatus.

{
  "status": enum (Status)
}

enum (Status)

Trạng thái. Vui lòng xem StopLostModeStatus.