Method: enterprises.devices.issueCommand

Ra lệnh cho một thiết bị. Tài nguyên Operation được trả về chứa một Command trong trường metadata. Sử dụng phương thức get operation để biết trạng thái của lệnh.

Yêu cầu HTTP

POST https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}:issueCommand

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
name

string

Tên của thiết bị ở dạng enterprises/{enterpriseId}/devices/{deviceId}.

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của Command.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Operation.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/androidmanagement

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

Lệnh

Một lệnh.

Biểu diễn dưới dạng JSON 
{
  "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)
  },
  "addEsimParams": {
    object (AddEsimParams)
  },
  "removeEsimParams": {
    object (RemoveEsimParams)
  },
  "requestDeviceInfoParams": {
    object (RequestDeviceInfoParams)
  },
  "wipeParams": {
    object (WipeParams)
  }
  // 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)
  },
  "esimStatus": {
    object (EsimCommandStatus)
  },
  "requestDeviceInfoStatus": {
    object (RequestDeviceInfoStatus)
  }
  // End of list of possible types for union field status.
}
Trường
type

enum (CommandType)

Loại lệnh.
createTime

string (Timestamp format)

Dấu thời gian cho biết thời điểm tạo lệnh. Dấu thời gian do máy chủ tự động tạo.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
duration

string (Duration format)

Khoảng thời gian mà lệnh có hiệu lực. Lệnh sẽ hết hạn nếu thiết bị không thực thi trong thời gian này. Khoảng thời gian mặc định nếu không được chỉ định là 10 phút. Không có giới hạn về 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".
userName

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}. Thông tin này được máy chủ tự động tạo dựa trên thiết bị mà lệnh được gửi đến.
errorCode

enum (CommandErrorCode)

Nếu lệnh không thành công, hệ thống sẽ trả về một mã lỗi giải thích lý do không thành công. Giá trị này không được đặt khi lệnh bị huỷ bởi phương thức gọi. Để lý giải về lỗi lệnh, hãy ưu tiên các trường theo thứ tự sau (ưu tiên nhất trước): 1. Các trường dành riêng cho lệnh như clearAppsDataStatus, startLostModeStatus hoặc các trường tương tự (nếu có). 2. Trường này (nếu được đặt). 3. Trường error chung trong Operation bao bọc lệnh.
newPassword

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ó ít nhất 6 ký tự nếu là mật khẩu số trên các thiết bị Android 14. Nếu không, lệnh sẽ không thành công với INVALID_VALUE.
resetPasswordFlags[]

enum (ResetPasswordFlag)

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

Trường nhóm params. Các thông số dành riêng cho lệnh. Xin lưu ý rằng một số lệnh không sử dụng tham số này, đặc biệt là LOCK, RESET_PASSWORD, REBOOT và RELINQUISH_OWNERSHIP. Trong tương lai, các lệnh này cũng có thể sử dụng tính năng này.

Nếu bạn đặt giá trị này, thì không được đặt các trường new_password và reset_password_flags. params chỉ có thể là một trong những trạng thái sau:
clearAppsDataParams

object (ClearAppsDataParams)

Các tham số cho lệnh CLEAR_APP_DATA để xoá dữ liệu của các ứng dụng được chỉ định khỏi thiết bị. Vui lòng xem ClearAppsDataParams. Nếu bạn đặt chính sách này, thì 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 type thành CLEAR_APP_DATA một cách rõ ràng.
startLostModeParams

object (StartLostModeParams)

Các tham số cho lệnh START_LOST_MODE để chuyển thiết bị sang chế độ thiết bị bị mất. Vui lòng xem StartLostModeParams. Nếu bạn đặt chính sách này, thì 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 type thành START_LOST_MODE một cách rõ ràng.
stopLostModeParams

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 chính sách này, thì 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 type thành STOP_LOST_MODE một cách rõ ràng.
addEsimParams

object (AddEsimParams)

Không bắt buộc. Các tham số cho lệnh ADD_ESIM để thêm một hồ sơ eSIM vào thiết bị. Nếu bạn đặt chính sách này, thì 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 ADD_ESIM. Bạn cũng có thể đặt type thành ADD_ESIM một cách rõ ràng.
removeEsimParams

object (RemoveEsimParams)

Không bắt buộc. Các tham số cho lệnh REMOVE_ESIM để xoá một hồ sơ eSIM khỏi thiết bị. Nếu bạn đặt chính sách này, thì 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 REMOVE_ESIM. Bạn cũng có thể đặt type thành REMOVE_ESIM một cách rõ ràng.
requestDeviceInfoParams

object (RequestDeviceInfoParams)

Không bắt buộc. Các tham số cho lệnh REQUEST_DEVICE_INFO để lấy thông tin liên quan đến thiết bị. Nếu bạn đặt chính sách này, thì 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 REQUEST_DEVICE_INFO . Bạn cũng có thể đặt type thành REQUEST_DEVICE_INFO một cách rõ ràng.
wipeParams

object (WipeParams)

Không bắt buộc. Các tham số cho lệnh WIPE để xoá dữ liệu trên thiết bị. Nếu bạn đặt chính sách này, thì 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 WIPE. Bạn cũng có thể đặt type thành WIPE một cách rõ ràng.
Trường nhóm status. Trạng thái dành riêng cho lệnh. Xin lưu ý rằng một số lệnh không sử dụng tham số này, đặc biệt là LOCK, RESET_PASSWORD, REBOOT và RELINQUISH_OWNERSHIP. Trong tương lai, các lệnh này cũng có thể sử dụng tính năng này. status chỉ có thể là một trong những trạng thái sau:
clearAppsDataStatus

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 được chỉ định khỏi thiết bị. Vui lòng xem ClearAppsDataStatus.
startLostModeStatus

object (StartLostModeStatus)

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

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.
esimStatus

object (EsimCommandStatus)

Chỉ có đầu ra. Trạng thái của lệnh ADD_ESIM hoặc REMOVE_ESIM.
requestDeviceInfoStatus

object (RequestDeviceInfoStatus)

Chỉ có đầu ra. Trạng thái của lệnh REQUEST_DEVICE_INFO.

CommandType

Các loại lệnh.

Enum
COMMAND_TYPE_UNSPECIFIED Giá trị này không được phép.
LOCK Khoá thiết bị, như thể thời gian chờ khoá màn hình đã hết.
RESET_PASSWORD Đặt lại mật khẩu của người dùng.
REBOOT Khởi động lại thiết bị. Chỉ được hỗ trợ trên các thiết bị do công ty quản lý hoàn toàn chạy Android 7.0 (API cấp 24) trở lên.
RELINQUISH_OWNERSHIP Xoá hồ sơ công việc và tất cả các chính sách khỏi thiết bị Android 8.0 trở lên thuộc sở hữu của công ty, cho phép người dùng sử dụng thiết bị cho mục đích cá nhân. Các ứng dụng và dữ liệu liên kết với(các) hồ sơ cá nhân sẽ được giữ lại. Thiết bị sẽ bị xoá khỏi máy chủ sau khi xác nhận lệnh.
CLEAR_APP_DATA Xoá dữ liệu ứng dụng của các ứng dụng được chỉ định. Tính năng này được hỗ trợ trên Android 9 trở lên. Xin lưu ý rằng một ứng dụng có thể lưu trữ dữ liệu bên ngoài dữ liệu ứng dụng của ứng dụng đó, ví dụ: trong bộ nhớ ngoài hoặc trong từ điển người dùng. Xem thêm clearAppsDataParams.
START_LOST_MODE Đặt thiết bị ở chế độ thất lạc. Chỉ được hỗ trợ trên các thiết bị được quản lý hoàn toàn hoặc thiết bị do tổ chức sở hữu có hồ sơ được quản lý. Xem thêm startLostModeParams.
STOP_LOST_MODE Đưa thiết bị ra khỏi chế độ thất lạc. Chỉ được hỗ trợ trên các thiết bị được quản lý hoàn toàn hoặc thiết bị do tổ chức sở hữu có hồ sơ được quản lý. Xem thêm stopLostModeParams.
ADD_ESIM Thêm một hồ sơ eSIM vào thiết bị. Chế độ này được hỗ trợ trên Android 15 trở lên. Xem thêm addEsimParams. Để xoá một hồ sơ eSIM, hãy dùng lệnh REMOVE_ESIM. Để xác định điều gì sẽ xảy ra với hồ sơ eSIM khi thiết bị bị xoá dữ liệu, hãy đặt wipeDataFlags trong chính sách. Lưu ý: Để cung cấp nhiều eSIM trên một thiết bị, bạn nên trì hoãn vài phút giữa các lần thực thi lệnh liên tiếp.
REMOVE_ESIM Xoá một hồ sơ eSIM khỏi thiết bị. Chế độ này được hỗ trợ trên Android 15 trở lên. Xem thêm removeEsimParams.
REQUEST_DEVICE_INFO Yêu cầu thông tin liên quan đến thiết bị.
WIPE Xoá sạch dữ liệu trên thiết bị thông qua quy trình khôi phục cài đặt gốc đối với thiết bị do công ty sở hữu hoặc bằng cách xoá hồ sơ công việc đối với thiết bị cá nhân có hồ sơ công việc. Chỉ khi thiết bị xác nhận lệnh thì dữ liệu mới bị xoá. Bạn có thể huỷ lệnh trước thời điểm đó.

CommandErrorCode

Mã lỗi lệnh. Đây là một trường chỉ đọc do máy chủ điền sẵn.

Enum
COMMAND_ERROR_CODE_UNSPECIFIED Không có lỗi nào.
UNKNOWN Đã xảy ra lỗi không xác định.
API_LEVEL Cấp độ API của thiết bị không hỗ trợ lệnh này.
MANAGEMENT_MODE Chế độ quản lý (chủ sở hữu hồ sơ, chủ sở hữu thiết bị, v.v.) không hỗ trợ lệnh này.
INVALID_VALUE Lệnh có giá trị tham số không hợp lệ.
UNSUPPORTED Thiết bị không hỗ trợ lệnh này. Việc cập nhật Chính sách thiết bị Android lên phiên bản mới nhất có thể giải quyết vấn đề này.

ResetPasswordFlag

Các cờ có thể dùng cho loại lệnh RESET_PASSWORD.

Enum
RESET_PASSWORD_FLAG_UNSPECIFIED Giá trị này sẽ bị bỏ qua.
REQUIRE_ENTRY Không cho phép quản trị viên khác thay đổi mật khẩu lần nữa cho đến khi người dùng nhập mật khẩu.
DO_NOT_ASK_CREDENTIALS_ON_BOOT Không yêu cầu thông tin đăng nhập của người dùng khi khởi động thiết bị.
LOCK_NOW Khoá thiết bị sau khi đặt lại mật khẩu.

ClearAppsDataParams

Các tham số liên kết với lệnh CLEAR_APP_DATA để xoá dữ liệu của các ứng dụng được chỉ định khỏi thiết bị.

Biểu diễn dưới dạng JSON 
{
  "packageNames": [
    string
  ]
}
Trường
packageNames[]

string

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

StartLostModeParams

Các tham số liên kết với lệnh START_LOST_MODE để chuyển thiết bị sang chế độ thất lạc. Bạn phải cung cấp ít nhất một tham số (không bao gồm tên tổ chức) để đưa thiết bị vào chế độ mất.

Biểu diễn dưới dạng JSON 
{
  "lostMessage": {
    object (UserFacingMessage)
  },
  "lostPhoneNumber": {
    object (UserFacingMessage)
  },
  "lostEmailAddress": string,
  "lostStreetAddress": {
    object (UserFacingMessage)
  },
  "lostOrganization": {
    object (UserFacingMessage)
  }
}
Trường
lostMessage

object (UserFacingMessage)

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

object (UserFacingMessage)

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

string

Địa chỉ email mà người dùng nhìn thấy khi thiết bị ở chế độ thất lạc.
lostStreetAddress

object (UserFacingMessage)

Địa chỉ đường phố mà người dùng nhìn thấy khi thiết bị ở chế độ thất lạc.
lostOrganization

object (UserFacingMessage)

Tên tổ chức mà người dùng nhìn thấy khi thiết bị ở chế độ thất lạc.

StopLostModeParams

Loại này không có trường nào.

Các tham số liên kết với lệnh STOP_LOST_MODE để đưa thiết bị ra khỏi chế độ thất lạc.

AddEsimParams

Các tham số liên kết với lệnh ADD_ESIM để thêm một hồ sơ eSIM vào thiết bị.

Biểu diễn dưới dạng JSON 
{
  "activationCode": string,
  "activationState": enum (ActivationState)
}
Trường
activationCode

string

Bắt buộc. Mã kích hoạt cho hồ sơ eSIM.
activationState

enum (ActivationState)

Bắt buộc. Trạng thái kích hoạt của hồ sơ eSIM sau khi được tải xuống.

ActivationState

Trạng thái kích hoạt của hồ sơ eSIM sau khi được tải xuống.

Enum
ACTIVATION_STATE_UNSPECIFIED Bạn chưa chỉ định trạng thái kích hoạt eSIM. Theo mặc định, hồ sơ eSIM sẽ là NOT_ACTIVATED trên thiết bị thuộc sở hữu cá nhân và ACTIVATED trên thiết bị thuộc sở hữu của công ty.
ACTIVATED eSIM sẽ tự động kích hoạt sau khi bạn tải xuống. Nếu bạn đặt trạng thái này làm trạng thái kích hoạt cho các thiết bị thuộc sở hữu cá nhân, thì lệnh sẽ bị từ chối.
NOT_ACTIVATED Hồ sơ eSIM đã được tải xuống nhưng chưa được kích hoạt. Trong trường hợp này, người dùng sẽ cần kích hoạt eSIM theo cách thủ công trên thiết bị.

RemoveEsimParams

Các thông số liên kết với lệnh REMOVE_ESIM để xoá một hồ sơ eSIM khỏi thiết bị.

Biểu diễn dưới dạng JSON 
{
  "iccId": string
}
Trường
iccId

string

Bắt buộc. Mã nhận dạng thẻ SIM (ICCID) của hồ sơ eSIM cần xoá.

RequestDeviceInfoParams

Các tham số liên kết với lệnh REQUEST_DEVICE_INFO để lấy thông tin liên quan đến thiết bị.

Biểu diễn dưới dạng JSON 
{
  "deviceInfo": enum (DeviceInfo)
}
Trường
deviceInfo

enum (DeviceInfo)

Bắt buộc. Loại thông tin thiết bị cần được yêu cầu.

DeviceInfo

Loại thông tin thiết bị cần được yêu cầu.

Enum
DEVICE_INFO_UNSPECIFIED Giá trị này không được phép.
EID Yêu cầu giá trị nhận dạng cho eSIM. Người dùng sẽ được yêu cầu phê duyệt việc công bố thông tin trước khi kết quả có thể được trả về. Nếu người dùng không phê duyệt thông tin công bố, USER_DECLINED sẽ được trả về. Chế độ này chỉ được hỗ trợ cho các thiết bị cá nhân có hồ sơ công việc và chạy Android phiên bản 13 trở lên.

WipeParams

Các tham số liên kết với lệnh WIPE để xoá dữ liệu trên thiết bị.

Biểu diễn dưới dạng JSON 
{
  "wipeDataFlags": [
    enum (WipeDataFlag)
  ],
  "wipeReason": {
    object (UserFacingMessage)
  }
}
Trường
wipeDataFlags[]

enum (WipeDataFlag)

Không bắt buộc. Các cờ để xác định dữ liệu cần xoá.
wipeReason

object (UserFacingMessage)

Không bắt buộc. Một thông báo ngắn hiển thị cho người dùng trước khi xoá sạch hồ sơ công việc trên thiết bị cá nhân. Điều này không ảnh hưởng đến các thiết bị thuộc quyền sở hữu của công ty. Độ dài tối đa của thông báo là 200 ký tự.

ClearAppsDataStatus

Trạng thái của lệnh CLEAR_APP_DATA để xoá dữ liệu của các ứng dụng được chỉ định khỏi thiết bị.

Biểu diễn dưới dạng JSON 
{
  "results": {
    string: {
      object (PerAppResult)
    },
    ...
  }
}
Trường
results

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

Kết quả cho 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" }.

PerAppResult

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

Biểu diễn dưới dạng JSON 
{
  "clearingResult": enum (ClearingResult)
}
Trường
clearingResult

enum (ClearingResult)

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

ClearingResult

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

Enum
CLEARING_RESULT_UNSPECIFIED Kết quả không xác định.
SUCCESS Đã xoá thành công dữ liệu của ứng dụng này.
APP_NOT_FOUND Không thể xoá dữ liệu của ứng dụng này vì không tìm thấy ứng dụng.
APP_PROTECTED Không thể xoá dữ liệu của ứng dụng này vì ứng dụng được bảo vệ. Ví dụ: điều này có thể áp dụng cho các ứng dụng quan trọng đối với hoạt động của thiết bị, chẳng hạn như Cửa hàng Google Play.
API_LEVEL Không thể xoá dữ liệu của ứng dụng này vì cấp độ API của thiết bị không hỗ trợ lệnh này.

StartLostModeStatus

Trạng thái của lệnh START_LOST_MODE để chuyển thiết bị sang chế độ thiết bị bị mất.

Biểu diễn dưới dạng JSON 
{
  "status": enum (Status)
}
Trường
status

enum (Status)

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

Trạng thái

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

Enum
STATUS_UNSPECIFIED Không xác định. Giá trị này không được sử dụng.
SUCCESS Thiết bị đã chuyển sang chế độ thất lạc.
RESET_PASSWORD_RECENTLY Không thể chuyển thiết bị sang chế độ thất lạc vì gần đây quản trị viên đã đặt lại mật khẩu của thiết bị.
USER_EXIT_LOST_MODE_RECENTLY Không thể chuyển thiết bị sang chế độ thất lạc vì gần đây người dùng đã thoát chế độ này.
ALREADY_IN_LOST_MODE Thiết bị đã ở chế độ thất lạc.

StopLostModeStatus

Trạng thái của lệnh STOP_LOST_MODE để đưa thiết bị ra khỏi chế độ thất lạc.

Biểu diễn dưới dạng JSON 
{
  "status": enum (Status)
}
Trường
status

enum (Status)

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

Trạng thái

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

Enum
STATUS_UNSPECIFIED Không xác định. Giá trị này không được sử dụng.
SUCCESS Thiết bị đã thoát khỏi chế độ thất lạc.
NOT_IN_LOST_MODE Thiết bị không ở chế độ thất lạc.

EsimCommandStatus

Trạng thái và thông tin chi tiết về lỗi (nếu có) của lệnh ADD_ESIM hoặc REMOVE_ESIM.

Biểu diễn dưới dạng JSON 
{
  "status": enum (Status),
  "esimInfo": {
    object (EsimInfo)
  },

  // Union field status_details can be only one of the following:
  "internalErrorDetails": {
    object (InternalErrorDetails)
  }
  // End of list of possible types for union field status_details.
}
Trường
status

enum (Status)

Chỉ có đầu ra. Trạng thái của lệnh ADD_ESIM hoặc REMOVE_ESIM.
esimInfo

object (EsimInfo)

Chỉ có đầu ra. Thông tin về eSIM được thêm hoặc xoá. Trường này chỉ được điền sẵn khi thao tác eSIM status là SUCCESS.
Trường nhóm status_details. Thông tin chi tiết về trạng thái của lệnh ADD_ESIM hoặc REMOVE_ESIM. status_details chỉ có thể là một trong những trạng thái sau:
internalErrorDetails

object (InternalErrorDetails)

Chỉ có đầu ra. Thông tin chi tiết về lỗi nếu status được đặt thành INTERNAL_ERROR.

Trạng thái

Trạng thái của lệnh ADD_ESIM hoặc REMOVE_ESIM.

Enum
STATUS_UNSPECIFIED Không xác định. Giá trị này không được sử dụng.
SUCCESS Thao tác eSIM đã được thực hiện thành công trên thiết bị.
IN_PROGRESS Đang thực hiện thao tác với eSIM.
PENDING_USER_ACTION Người dùng cần thực hiện một thao tác để quá trình hoạt động của eSIM tiếp tục.
ERROR_SETUP_IN_PROGRESS Không thể thực hiện thao tác eSIM khi đang thiết lập.
ERROR_USER_DENIED Người dùng đã từ chối thao tác eSIM.
INTERNAL_ERROR Đã xảy ra lỗi khi cố gắng thêm hoặc xoá eSIM trên thiết bị, hãy xem internalErrorDetails.
ERROR_ICC_ID_NOT_FOUND Đối với lệnh REMOVE_ESIM, không tìm thấy iccId của eSIM cần xoá trên thiết bị. Điều này có thể có nghĩa là eSIM không thuộc về doanh nghiệp hoặc eSIM tương ứng với iccId không có trên thiết bị.
ERROR_MULTIPLE_ACTIVE_ESIMS_NO_AVAILABLE_SLOT Lệnh ADD_ESIM không thành công khi cố gắng thêm một eSIM mới có trạng thái kích hoạt được đặt thành ACTIVATED vì nhiều khe cắm eSIM trên thiết bị chứa các hồ sơ eSIM đang hoạt động và không có khe cắm eSIM nào còn trống. Để giải quyết vấn đề này, bạn có thể thêm eSIM mới với trạng thái kích hoạt là NOT_ACTIVATED để kích hoạt theo cách thủ công sau này, hoặc trước tiên, người dùng phải huỷ kích hoạt một eSIM đang hoạt động hiện có để tiếp tục thao tác.

InternalErrorDetails

Thông tin chi tiết về lỗi nội bộ (nếu có) cho lệnh ADD_ESIM hoặc REMOVE_ESIM.

Biểu diễn dưới dạng JSON 
{
  "operationCode": string,
  "errorCode": string,
  "operationCodeDetail": enum (OperationCodeDetail),
  "errorCodeDetail": enum (ErrorCodeDetail)
}
Trường
operationCode

string (int64 format)

Chỉ có đầu ra. Biểu thị số nguyên của mã thao tác như được chỉ định tại đây. Hãy xem operationCodeDetail để biết thêm thông tin.
errorCode

string (int64 format)

Chỉ có đầu ra. Biểu thị số nguyên của mã lỗi như được chỉ định tại đây. Xem thêm OPERATION_SMDX_SUBJECT_REASON_CODE. Hãy xem errorCodeDetail để biết thêm thông tin.
operationCodeDetail

enum (OperationCodeDetail)

Chỉ có đầu ra. Thông tin chi tiết về mã thao tác tương ứng với operationCode.
errorCodeDetail

enum (ErrorCodeDetail)

Chỉ có đầu ra. Thông tin chi tiết về mã lỗi tương ứng với errorCode.

OperationCodeDetail

Thông tin chi tiết về mã thao tác tương ứng với operationCode.

Enum
OPERATION_CODE_DETAIL_UNSPECIFIED Không chỉ định thông tin chi tiết về mã thao tác. Android Management API không nhận dạng được operationCode. Tuy nhiên, hãy xem operationCode.
OPERATION_SYSTEM Hãy xem EuiccManager.OPERATION_SYSTEM để biết thông tin chi tiết.
OPERATION_SIM_SLOT Hãy xem EuiccManager.OPERATION_SIM_SLOT để biết thông tin chi tiết.
OPERATION_EUICC_CARD Hãy xem EuiccManager.OPERATION_EUICC_CARD để biết thông tin chi tiết.
OPERATION_SMDX Hãy xem EuiccManager.OPERATION_SMDX để biết thông tin chi tiết.
OPERATION_SWITCH Hãy xem EuiccManager.OPERATION_SWITCH để biết thông tin chi tiết.
OPERATION_DOWNLOAD Hãy xem EuiccManager.OPERATION_DOWNLOAD để biết thông tin chi tiết.
OPERATION_METADATA Hãy xem EuiccManager.OPERATION_METADATA để biết thông tin chi tiết.
OPERATION_EUICC_GSMA Hãy xem EuiccManager.OPERATION_EUICC_GSMA để biết thông tin chi tiết.
OPERATION_APDU Hãy xem EuiccManager.OPERATION_APDU để biết thông tin chi tiết.
OPERATION_SMDX_SUBJECT_REASON_CODE Hãy xem EuiccManager.OPERATION_SMDX_SUBJECT_REASON_CODE để biết thông tin chi tiết. Xin lưu ý rằng trong trường hợp này, errorCode là 3 byte ít quan trọng nhất của EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE, chỉ định mã chủ đề và mã lý do như được chỉ ra tại đây. Byte có nghĩa nhất của số nguyên sẽ được đặt thành 0. Ví dụ: Mã chủ đề là 8.11.1 và Mã lý do là 5.1 được biểu thị trong errorCode dưới dạng 0000 0000 1000 1011 0001 0000 0101 0001 trong hệ nhị phân, tương đương với 9113681 trong hệ thập phân.
OPERATION_HTTP Hãy xem EuiccManager.OPERATION_HTTP để biết thông tin chi tiết.

ErrorCodeDetail

Thông tin chi tiết về mã lỗi tương ứng với errorCode.

Enum
ERROR_CODE_DETAIL_UNSPECIFIED Không xác định chi tiết mã lỗi. Android Management API không nhận dạng được errorCode. Tuy nhiên, hãy xem phần errorCode
ERROR_TIME_OUT Hãy xem EuiccManager.ERROR_TIME_OUT để biết thông tin chi tiết.
ERROR_EUICC_MISSING Hãy xem EuiccManager.ERROR_EUICC_MISSING để biết thông tin chi tiết.
ERROR_UNSUPPORTED_VERSION Hãy xem EuiccManager.ERROR_UNSUPPORTED_VERSION để biết thông tin chi tiết.
ERROR_ADDRESS_MISSING Hãy xem EuiccManager.ERROR_ADDRESS_MISSING để biết thông tin chi tiết.
ERROR_INVALID_CONFIRMATION_CODE Hãy xem EuiccManager.ERROR_INVALID_CONFIRMATION_CODE để biết thông tin chi tiết.
ERROR_CERTIFICATE_ERROR Hãy xem EuiccManager.ERROR_CERTIFICATE_ERROR để biết thông tin chi tiết.
ERROR_NO_PROFILES_AVAILABLE Hãy xem EuiccManager.ERROR_NO_PROFILES_AVAILABLE để biết thông tin chi tiết.
ERROR_CONNECTION_ERROR Hãy xem EuiccManager.ERROR_CONNECTION_ERROR để biết thông tin chi tiết.
ERROR_INVALID_RESPONSE Hãy xem EuiccManager.ERROR_INVALID_RESPONSE để biết thông tin chi tiết.
ERROR_CARRIER_LOCKED Hãy xem EuiccManager.ERROR_CARRIER_LOCKED để biết thông tin chi tiết.
ERROR_DISALLOWED_BY_PPR Hãy xem EuiccManager.ERROR_DISALLOWED_BY_PPR để biết thông tin chi tiết.
ERROR_INVALID_ACTIVATION_CODE Hãy xem EuiccManager.ERROR_INVALID_ACTIVATION_CODE để biết thông tin chi tiết.
ERROR_INCOMPATIBLE_CARRIER Hãy xem EuiccManager.ERROR_INCOMPATIBLE_CARRIER để biết thông tin chi tiết.
ERROR_OPERATION_BUSY Hãy xem EuiccManager.ERROR_OPERATION_BUSY để biết thông tin chi tiết.
ERROR_INSTALL_PROFILE Hãy xem EuiccManager.ERROR_INSTALL_PROFILE để biết thông tin chi tiết.
ERROR_EUICC_INSUFFICIENT_MEMORY Hãy xem EuiccManager.ERROR_EUICC_INSUFFICIENT_MEMORY để biết thông tin chi tiết.
ERROR_INVALID_PORT Hãy xem EuiccManager.ERROR_INVALID_PORT để biết thông tin chi tiết.
ERROR_SIM_MISSING Hãy xem EuiccManager.ERROR_SIM_MISSING để biết thông tin chi tiết.

EsimInfo

Thông tin chi tiết về eSIM được thêm hoặc xoá.

Biểu diễn dưới dạng JSON 
{
  "iccId": string
}
Trường
iccId

string

Chỉ có đầu ra. Mã nhận dạng thẻ SIM tích hợp (ICCID) của eSIM.

RequestDeviceInfoStatus

Trạng thái của lệnh REQUEST_DEVICE_INFO.

Biểu diễn dưới dạng JSON 
{
  "status": enum (Status),

  // Union field device_info can be only one of the following:
  "eidInfo": {
    object (EidInfo)
  }
  // End of list of possible types for union field device_info.
}
Trường
status

enum (Status)

Chỉ có đầu ra. Trạng thái của lệnh REQUEST_DEVICE_INFO.
Trường nhóm device_info. Thông tin chi tiết về thông tin thiết bị mà quản trị viên yêu cầu. Trường này chỉ được điền sẵn khi status là SUCCEEDED. device_info chỉ có thể là một trong những trạng thái sau:
eidInfo

object (EidInfo)

Thông tin liên quan đến mã nhận dạng thiết bị đã đăng ký (EID) của thiết bị.

Trạng thái

Trạng thái của lệnh REQUEST_DEVICE_INFO.

Enum
STATUS_UNSPECIFIED Không xác định. Giá trị này không được sử dụng.
SUCCEEDED Đã gửi thông tin thiết bị thành công.
PENDING_USER_ACTION Người dùng chưa hoàn tất các thao tác cần thiết để chia sẻ thông tin thiết bị.
USER_DECLINED Người dùng từ chối chia sẻ thông tin thiết bị.
UNSUPPORTED Thiết bị này không hỗ trợ thông tin thiết bị được yêu cầu, chẳng hạn như thiết bị không hỗ trợ eSIM.

EidInfo

Thông tin liên quan đến mã nhận dạng thiết bị đã đăng ký (EID) của thiết bị.

Biểu diễn dưới dạng JSON 
{
  "eids": [
    {
      object (Eid)
    }
  ]
}
Trường
eids[]

object (Eid)

Chỉ có đầu ra. Thông tin EID cho từng chip eUICC.

Eid

Thông tin EID cho từng chip eUICC.

Biểu diễn dưới dạng JSON 
{
  "eid": string
}
Trường
eid

string

Chỉ có đầu ra. EID