Method: customer.devices.chromeos.issueCommand

Ra lệnh cho thiết bị thực thi.

Yêu cầu HTTP

POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}:issueCommand

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

Tham số đường dẫn

Thông số
customerId

string

Không thể thay đổi. Mã nhận dạng của tài khoản Google Workspace.

deviceId

string

Không thể thay đổi. Mã nhận dạng của thiết bị Chrome OS.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

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

enum (CommandType)

Loại lệnh.

payload

string

Tải trọng cho lệnh, chỉ cung cấp nếu lệnh hỗ trợ tải trọng. Các lệnh sau đây hỗ trợ việc thêm tải trọng:

  • SET_VOLUME: Tải trọng là một đối tượng JSON được chuyển đổi thành chuỗi ở dạng: { "volume": 50 }. Âm lượng phải là một số nguyên trong phạm vi [0,100].
  • DEVICE_START_CRD_SESSION: Tải trọng là một đối tượng JSON được chuyển đổi thành chuỗi (không bắt buộc) ở dạng: { "ackedUserPresence": true, "crdSessionType": string }. ackedUserPresence là một giá trị boolean. Theo mặc định, ackedUserPresence được đặt thành false. Để bắt đầu một phiên Chrome Remote Desktop cho một thiết bị đang hoạt động, hãy đặt ackedUserPresence thành true. crdSessionType chỉ có thể chọn trong số các giá trị private (cho phép quản trị viên từ xa có quyền kiểm soát độc quyền đối với thiết bị ChromeOS) hoặc shared (cho phép quản trị viên và người dùng cục bộ cùng kiểm soát thiết bị ChromeOS). Nếu không được đặt, crdSessionType sẽ mặc định là shared. Bạn có thể dùng lệnh FETCH_CRD_AVAILABILITY_INFO để xác định các loại phiên hiện có trên thiết bị.
  • REBOOT: Tải trọng là một đối tượng JSON được chuyển đổi thành chuỗi ở dạng: { "user_session_delay_seconds": 300 }. user_session_delay_seconds là số giây cần đợi trước khi khởi động lại thiết bị nếu người dùng đã đăng nhập. Đây phải là một số nguyên trong phạm vi [0,300]. Khi không có tải trọng để khởi động lại, độ trễ mặc định là 0. Lưu ý: Điều này chỉ áp dụng nếu người dùng thực tế đã đăng nhập, kể cả Khách. Nếu thiết bị đang ở màn hình đăng nhập hoặc ở chế độ Kiosk, thì giá trị này sẽ không được tuân thủ và thiết bị sẽ khởi động lại ngay lập tức.
  • FETCH_SUPPORT_PACKET: Tải trọng là một đối tượng JSON được chuyển đổi thành chuỗi (không bắt buộc) ở dạng: {"supportPacketDetails":{ "issueCaseId": optional_support_case_id_string, "issueDescription": optional_issue_description_string, "requestedDataCollectors": [<comma-separated list of data_collector_enums integer values>]}}
    Danh sách data_collector_enums có sẵn như sau: Thông tin hệ thống Chrome (1), Mã sự cố (2), Thông tin chi tiết về bộ nhớ (3), Cấu trúc giao diện người dùng (4), Nhật ký nền tảng ChromeOS bổ sung (5), Sự kiện thiết bị (6), Kết xuất gỡ lỗi NIC WiFi Intel (7), Sự kiện chạm (8), Lacros (9), Thông tin hệ thống Lacros (10), Nhật ký ChromeOS Flex (11), Thông tin chi tiết về DBus (12), Tuyến mạng ChromeOS (13), Nhật ký ChromeOS Shill (Trình quản lý kết nối) (14), Chính sách (15), Trạng thái và nhật ký hệ thống ChromeOS (16), Nhật ký hệ thống ChromeOS (17), Nhật ký người dùng Chrome trên ChromeOS (18), Bluetooth ChromeOS (19), Thiết bị đầu vào được kết nối trên ChromeOS (20), Bộ đếm lưu lượng truy cập ChromeOS (21), Bàn phím ảo ChromeOS (22), Tình trạng mạng ChromeOS (23).
    Xem thêm thông tin chi tiết trong bài viết trợ giúp.

Nội dung phản hồi

Phản hồi cho việc phát lệnh.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

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

string (int64 format)

Mã nhận dạng duy nhất của lệnh đã phát hành, dùng để truy xuất trạng thái lệnh.

Phạm vi uỷ quyền

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

  • https://www.googleapis.com/auth/admin.directory.device.chromeos

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.