- Yêu cầu HTTP
- Tham số đường dẫn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- Lệnh
- CommandType
- CommandErrorCode
- ResetPasswordFlag
- ClearAppsDataParams
- StartLostModeParams
- StopLostModeParams
- ClearAppsDataStatus
- PerAppResult
- ClearingResult
- StartLostModeStatus
- Trạng thái
- StopLostModeStatus (Trạng thái dừng lại)
- Trạng thái
- Hãy làm thử!
Đưa ra lệnh cho một thiết bị. Tài nguyên Operation
được trả về chứa Command
trong trường metadata
. Sử dụng phương thức thao tác get để 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
Tham số | |
---|---|
name |
Tên của thiết bị ở dạng |
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 Tổng quan về OAuth 2.0.
Lệnh
Lệnh.
Biểu diễn dưới dạng JSON |
---|
{ "type": enum ( |
Trường | |
---|---|
type |
Loại lệnh. |
createTime |
Dấu thời gian mà lệnh được tạo. Dấu thời gian do máy chủ tự động tạo. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: |
duration |
Thời lượng 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 khoảng thời gian này. Thời lượng mặc định nếu 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 với tối đa 9 chữ số thập phân, kết thúc bằng " |
userName |
Tên tài nguyên của người dùng sở hữu thiết bị ở dạng |
errorCode |
Nếu lệnh không thực hiện được, sẽ có mã lỗi giải thích lỗi. Giá trị này không được thiết lập khi phương thức gọi huỷ lệnh. |
newPassword |
Đối với các lệnh thuộc loại |
resetPasswordFlags[] |
Đối với các lệnh thuộc loại |
Trường hợp Nếu đặt giá trị này, thì bạn không được đặt các trường |
|
clearAppsDataParams |
Tham số cho lệnh |
startLostModeParams |
Các tham số cho lệnh |
stopLostModeParams |
Các tham số để lệnh |
Trường hợp status . Trạng thái dành riêng cho lệnh. Hãy lưu ý rằng một số lệnh không sử dụng tuỳ chọn này, cụ thể là , , và . Trong tương lai, các lệnh này cũng có thể sử dụng tuỳ chọn này. status chỉ có thể là một trong những trạng thái sau: |
|
clearAppsDataStatus |
Chỉ có đầu ra. Trạng thái của lệnh |
startLostModeStatus |
Chỉ có đầu ra. Trạng thái của lệnh |
stopLostModeStatus |
Chỉ có đầu ra. Trạng thái của lệnh |
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 những thiết bị được quản lý đầy đủ và 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ả chính sách khỏi thiết bị chạy Android 8.0 trở lên thuộc quyền sở hữu của công ty, đồng thời từ bỏ thiết bị này để sử dụng cho mục đích cá nhân. Các ứng dụng và dữ liệu được liên kết với(các) hồ sơ cá nhân đều được giữ nguyên. 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 đã chỉ định. Tính năng này được hỗ trợ trên Android 9 trở lên. 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, ví dụ như trong bộ nhớ ngoài hoặc trong từ điển người dùng. Xem thêm . |
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ị thuộc sở hữu của tổ chức có hồ sơ được quản lý. Xem thêm . |
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ị thuộc sở hữu của tổ chức có hồ sơ được quản lý. Xem thêm . |
CommandErrorCode
Mã lỗi lệnh. Đây là trường chỉ có thể đọc do máy chủ điền sẵn.
Enum | |
---|---|
COMMAND_ERROR_CODE_UNSPECIFIED |
Không có lỗi. |
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 này có giá trị thông số không hợp lệ. |
UNSUPPORTED |
Thiết bị không hỗ trợ lệnh này. Việc cập nhật Android Device Policy lên phiên bản mới nhất có thể giải quyết được vấn đề này. |
ResetPasswordFlag
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 lại mật khẩu 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
để xoá dữ liệu của các ứng dụng đã chỉ định khỏi thiết bị.CLEAR_APP_DATA
Biểu diễn dưới dạng JSON |
---|
{ "packageNames": [ string ] } |
Trường | |
---|---|
packageNames[] |
Tên gói của các ứng dụng có dữ liệu sẽ bị xoá khi thực thi lệnh. |
StartLostModeParams
Các tham số liên kết với lệnh
để đặt thiết bị vào chế độ thất lạc. Bạn phải cung cấp ít nhất một trong các thông số (không bao gồm tên tổ chức) để thiết bị được đưa vào chế độ thất lạc.START_LOST_MODE
Biểu diễn dưới dạng JSON |
---|
{ "lostMessage": { object ( |
Trường | |
---|---|
lostMessage |
Thông báo mà người dùng nhìn thấy khi thiết bị ở chế độ thất lạc. |
lostPhoneNumber |
Số điện thoại sẽ được gọi khi thiết bị ở chế độ thất lạc và người dùng nhấn vào nút của chủ sở hữu cuộc gọi. |
lostEmailAddress |
Địa chỉ email mà người dùng nhìn thấy khi thiết bị ở chế độ thất lạc. |
lostStreetAddress |
Địa chỉ đường phố được hiển thị cho người dùng khi thiết bị ở chế độ thất lạc. |
lostOrganization |
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.
Các tham số liên kết với lệnh
để đưa thiết bị ra khỏi chế độ thất lạc.STOP_LOST_MODE
ClearAppsDataStatus
Trạng thái của lệnh
để xoá dữ liệu của các ứng dụng đã chỉ định khỏi thiết bị.CLEAR_APP_DATA
Biểu diễn dưới dạng JSON |
---|
{
"results": {
string: {
object ( |
Trường | |
---|---|
results |
Kết quả cho từng ứng dụng, ánh xạ từ tên gói đến kết quả xoá tương ứng. Đối tượng chứa danh sách các cặp |
PerAppResult
Kết quả của một lần tìm cách xoá dữ liệu của một ứng dụng.
Biểu diễn dưới dạng JSON |
---|
{
"clearingResult": enum ( |
Trường | |
---|---|
clearingResult |
Kết quả của một lần tìm cách xoá dữ liệu của một ứng dụng. |
ClearingResult
Kết quả của một lần tìm cách 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 do 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 đang đượ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 chức nă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
để đưa thiết bị vào chế độ thất lạc.START_LOST_MODE
Biểu diễn dưới dạng JSON |
---|
{
"status": enum ( |
Trường | |
---|---|
status |
Trạng thái. Vui lòng xem |
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ị đã bị chuyển sang chế độ thất lạc. |
RESET_PASSWORD_RECENTLY |
Không thể đặt thiết bị này vào 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ị vào chế độ thất lạc vì gần đây người dùng đã thoát khỏi chế độ thất lạc. |
ALREADY_IN_LOST_MODE |
Thiết bị đã ở chế độ thất lạc. |
StopLostModeStatus
Trạng thái của lệnh
để đưa thiết bị ra khỏi chế độ thất lạc.STOP_LOST_MODE
Biểu diễn dưới dạng JSON |
---|
{
"status": enum ( |
Trường | |
---|---|
status |
Trạng thái. Vui lòng xem |
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. |