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ã thiết bị Chrome OS.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có 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

Trọng tải cho lệnh, chỉ cung cấp nếu lệnh hỗ trợ. 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 đã chuyển đổi thành chuỗi ở dạng: { "volume": 50 }. Dung 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 đã chuyển đổi thành chuỗi ở dạng: { "ackedUserPresence": true, "crdSessionType": string }. ackedUserPresence là một 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 (cấp cho quản trị viên từ xa 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ộ chia sẻ quyền kiểm soát thiết bị ChromeOS). Nếu không được đặt, crdSessionType sẽ mặc định là shared.
  • REBOOT: Trọng tải 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 chờ trước khi khởi động lại thiết bị nếu người dùng đã đăng nhập. Đây phải là 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, bao gồm 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 sang chuỗi ở 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), Hệ phân cấp 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), Tệp báo lỗi 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ý Flex của ChromeOS (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 ChromeOS Chrome (18), Bluetooth ChromeOS (19), Thiết bị đầu vào đã kết nối 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 khi đưa ra 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, 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.