หน้านี้ได้รับการแปลโดย Cloud Translation API

Method: customer.devices.chromeos.issueCommand

ออกคำสั่งให้อุปกรณ์ดำเนินการ

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์

พารามิเตอร์
`customerId`	`string` เปลี่ยนแปลงไม่ได้ รหัสของบัญชี Google Workspace
`deviceId`	`string` เปลี่ยนแปลงไม่ได้ รหัสของอุปกรณ์ ChromeOS

customerId

string

เปลี่ยนแปลงไม่ได้ รหัสของบัญชี Google Workspace

deviceId

string

เปลี่ยนแปลงไม่ได้ รหัสของอุปกรณ์ ChromeOS

เนื้อความของคำขอ

เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON
{ "commandType": enum (`CommandType`), "payload": string }

ช่อง

ช่อง
`commandType`	`enum (CommandType)` ประเภทของคำสั่ง
`payload`	`string` เพย์โหลดสำหรับคำสั่ง ระบุเฉพาะในกรณีที่คำสั่งรองรับ คำสั่งต่อไปนี้รองรับการเพิ่มเพย์โหลด `SET_VOLUME`: เพย์โหลดคือออบเจ็กต์ JSON ที่แปลงเป็นสตริงในรูปแบบ { "volume": 50 } โดยระดับเสียงต้องเป็นจำนวนเต็มในช่วง [0,100] `DEVICE_START_CRD_SESSION`: เพย์โหลดอาจเป็นออบเจ็กต์ JSON ที่แปลงเป็นสตริงในรูปแบบ { "ackedUserPresence": true, "crdSessionType": string } `ackedUserPresence` เป็นบูลีน โดยค่าเริ่มต้น ระบบจะตั้งค่า `ackedUserPresence` เป็น `false` หากต้องการเริ่มเซสชัน Chrome Remote Desktop สำหรับอุปกรณ์ที่ใช้งานอยู่ ให้ตั้งค่า `ackedUserPresence` เป็น `true` `crdSessionType` เลือกได้เฉพาะค่า `private` (ซึ่งให้สิทธิ์ผู้ดูแลระบบระยะไกลควบคุมอุปกรณ์ ChromeOS แต่เพียงผู้เดียว) หรือ `shared` (ซึ่งอนุญาตให้ผู้ดูแลระบบและผู้ใช้ในพื้นที่แชร์การควบคุมอุปกรณ์ ChromeOS) หากไม่ได้ตั้งค่าไว้ `crdSessionType` จะใช้ `shared` เป็นค่าเริ่มต้น คุณใช้คำสั่ง `FETCH_CRD_AVAILABILITY_INFO` เพื่อระบุประเภทเซสชันที่ใช้ได้ในอุปกรณ์ `REBOOT`: เพย์โหลดคือออบเจ็กต์ JSON ที่แปลงเป็นสตริงในรูปแบบ { "user_session_delay_seconds": 300 } โดย `user_session_delay_seconds` คือจำนวนวินาทีที่จะรอ ก่อนรีบูตอุปกรณ์หากผู้ใช้เข้าสู่ระบบ ต้องเป็นจำนวนเต็มในช่วง [0,300] เมื่อไม่มีเพย์โหลดสำหรับการรีบูต ค่าเริ่มต้นคือไม่มีการหน่วงเวลา หมายเหตุ: การดำเนินการนี้จะมีผลเฉพาะในกรณีที่ผู้ใช้จริงเข้าสู่ระบบ รวมถึงผู้มาเยือน หากอุปกรณ์อยู่ในหน้าจอเข้าสู่ระบบหรือในโหมดคีออสก์ ระบบจะไม่สนใจค่าดังกล่าวและอุปกรณ์จะรีบูตทันที `FETCH_SUPPORT_PACKET`: เพย์โหลดอาจเป็นออบเจ็กต์ JSON ที่แปลงเป็นสตริงในรูปแบบ {"supportPacketDetails":{ "issueCaseId": optional_support_case_id_string, "issueDescription": optional_issue_description_string, "requestedDataCollectors": [<comma-separated list of `data_collector_enums` integer values>]}} รายการ `data_collector_enums` ที่ใช้ได้มีดังนี้ ข้อมูลระบบ Chrome (1), รหัสข้อขัดข้อง (2), รายละเอียดหน่วยความจำ (3), ลำดับชั้น UI (4), บันทึกแพลตฟอร์ม ChromeOS เพิ่มเติม (5), เหตุการณ์ในอุปกรณ์ (6), การดั๊มการแก้ไขข้อบกพร่องของ Intel WiFi NIC (7), เหตุการณ์การแตะ (8), Lacros (9), ข้อมูลระบบ Lacros (10), บันทึก ChromeOS Flex (11), รายละเอียด DBus (12), เส้นทางเครือข่าย ChromeOS (13), บันทึก ChromeOS Shill (Connection Manager) (14), นโยบาย (15), สถานะและบันทึกระบบ ChromeOS (16), บันทึกระบบ ChromeOS (17), บันทึกผู้ใช้ Chrome ใน ChromeOS (18), บลูทูธ ChromeOS (19), อุปกรณ์อินพุตที่เชื่อมต่อ ChromeOS (20), ตัวนับการรับส่งข้อมูล ChromeOS (21), คีย์บอร์ดเสมือน ChromeOS (22), สุขภาพเครือข่าย ChromeOS (23) ดูรายละเอียดเพิ่มเติมได้ในบทความช่วยเหลือ

commandType

enum (CommandType)

ประเภทของคำสั่ง

payload

string

เพย์โหลดสำหรับคำสั่ง ระบุเฉพาะในกรณีที่คำสั่งรองรับ คำสั่งต่อไปนี้รองรับการเพิ่มเพย์โหลด

SET_VOLUME: เพย์โหลดคือออบเจ็กต์ JSON ที่แปลงเป็นสตริงในรูปแบบ { "volume": 50 } โดยระดับเสียงต้องเป็นจำนวนเต็มในช่วง [0,100]
DEVICE_START_CRD_SESSION: เพย์โหลดอาจเป็นออบเจ็กต์ JSON ที่แปลงเป็นสตริงในรูปแบบ { "ackedUserPresence": true, "crdSessionType": string } ackedUserPresence เป็นบูลีน โดยค่าเริ่มต้น ระบบจะตั้งค่า ackedUserPresence เป็น false หากต้องการเริ่มเซสชัน Chrome Remote Desktop สำหรับอุปกรณ์ที่ใช้งานอยู่ ให้ตั้งค่า ackedUserPresence เป็น true crdSessionType เลือกได้เฉพาะค่า private (ซึ่งให้สิทธิ์ผู้ดูแลระบบระยะไกลควบคุมอุปกรณ์ ChromeOS แต่เพียงผู้เดียว) หรือ shared (ซึ่งอนุญาตให้ผู้ดูแลระบบและผู้ใช้ในพื้นที่แชร์การควบคุมอุปกรณ์ ChromeOS) หากไม่ได้ตั้งค่าไว้ crdSessionType จะใช้ shared เป็นค่าเริ่มต้น คุณใช้คำสั่ง FETCH_CRD_AVAILABILITY_INFO เพื่อระบุประเภทเซสชันที่ใช้ได้ในอุปกรณ์
REBOOT: เพย์โหลดคือออบเจ็กต์ JSON ที่แปลงเป็นสตริงในรูปแบบ { "user_session_delay_seconds": 300 } โดย user_session_delay_seconds คือจำนวนวินาทีที่จะรอ ก่อนรีบูตอุปกรณ์หากผู้ใช้เข้าสู่ระบบ ต้องเป็นจำนวนเต็มในช่วง [0,300] เมื่อไม่มีเพย์โหลดสำหรับการรีบูต ค่าเริ่มต้นคือไม่มีการหน่วงเวลา หมายเหตุ: การดำเนินการนี้จะมีผลเฉพาะในกรณีที่ผู้ใช้จริงเข้าสู่ระบบ รวมถึงผู้มาเยือน หากอุปกรณ์อยู่ในหน้าจอเข้าสู่ระบบหรือในโหมดคีออสก์ ระบบจะไม่สนใจค่าดังกล่าวและอุปกรณ์จะรีบูตทันที
FETCH_SUPPORT_PACKET: เพย์โหลดอาจเป็นออบเจ็กต์ JSON ที่แปลงเป็นสตริงในรูปแบบ {"supportPacketDetails":{ "issueCaseId": optional_support_case_id_string, "issueDescription": optional_issue_description_string, "requestedDataCollectors": [<comma-separated list of data_collector_enums integer values>]}}
รายการ data_collector_enums ที่ใช้ได้มีดังนี้ ข้อมูลระบบ Chrome (1), รหัสข้อขัดข้อง (2), รายละเอียดหน่วยความจำ (3), ลำดับชั้น UI (4), บันทึกแพลตฟอร์ม ChromeOS เพิ่มเติม (5), เหตุการณ์ในอุปกรณ์ (6), การดั๊มการแก้ไขข้อบกพร่องของ Intel WiFi NIC (7), เหตุการณ์การแตะ (8), Lacros (9), ข้อมูลระบบ Lacros (10), บันทึก ChromeOS Flex (11), รายละเอียด DBus (12), เส้นทางเครือข่าย ChromeOS (13), บันทึก ChromeOS Shill (Connection Manager) (14), นโยบาย (15), สถานะและบันทึกระบบ ChromeOS (16), บันทึกระบบ ChromeOS (17), บันทึกผู้ใช้ Chrome ใน ChromeOS (18), บลูทูธ ChromeOS (19), อุปกรณ์อินพุตที่เชื่อมต่อ ChromeOS (20), ตัวนับการรับส่งข้อมูล ChromeOS (21), คีย์บอร์ดเสมือน ChromeOS (22), สุขภาพเครือข่าย ChromeOS (23)
ดูรายละเอียดเพิ่มเติมได้ในบทความช่วยเหลือ

เนื้อหาการตอบกลับ

การตอบกลับสำหรับการออกคำสั่ง

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON
{ "commandId": string }

ช่อง

ช่อง
`commandId`	`string (int64 format)` รหัสที่ไม่ซ้ำกันของคำสั่งที่ออก ซึ่งใช้เพื่อดึงสถานะคำสั่ง

commandId

string (int64 format)

รหัสที่ไม่ซ้ำกันของคำสั่งที่ออก ซึ่งใช้เพื่อดึงสถานะคำสั่ง

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์