หน้านี้ได้รับการแปลโดย 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` เปลี่ยนแปลงไม่ได้ รหัสของอุปกรณ์ Chrome OS

customerId

string

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

deviceId

string

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

เนื้อหาของคำขอ

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

การแสดง 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` `REBOOT`: เพย์โหลดคือออบเจ็กต์ JSON ที่แปลงเป็นสตริงในรูปแบบ { "user_session_delay_seconds": 300 } โดย `user_session_delay_seconds` คือจำนวนวินาทีที่รอก่อนที่จะรีบูตอุปกรณ์หากผู้ใช้ลงชื่อเข้าใช้อยู่ ต้องเป็นจํานวนเต็มในช่วง [0,300] เมื่อไม่มีเพย์โหลดสำหรับการรีบูต ระบบจะใช้การหน่วงเวลา 0 เป็นค่าเริ่มต้น หมายเหตุ: การดำเนินการนี้จะมีผลเฉพาะในกรณีที่ผู้ใช้จริงเข้าสู่ระบบอยู่ ซึ่งรวมถึงผู้มาเยือน หากอุปกรณ์อยู่ในหน้าจอการเข้าสู่ระบบหรืออยู่ในโหมดคีออสก์ ระบบจะไม่ใช้ค่าดังกล่าวและรีบูตอุปกรณ์ทันที `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), ข้อมูลการแก้ไขข้อบกพร่องของ NIC ของ Intel WiFi (7), เหตุการณ์การสัมผัส (8), Lacros (9), ข้อมูลระบบ Lacros (10), บันทึก Flex ของ ChromeOS (11), รายละเอียด DBus (12), เส้นทางเครือข่ายของ ChromeOS (13), บันทึก Shill (ตัวจัดการการเชื่อมต่อ) ของ ChromeOS (14), นโยบาย (15), สถานะและบันทึกของระบบ ChromeOS (16), บันทึกของระบบ ChromeOS (17), บันทึกผู้ใช้ ChromeOS ของ Chrome (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
REBOOT: เพย์โหลดคือออบเจ็กต์ JSON ที่แปลงเป็นสตริงในรูปแบบ { "user_session_delay_seconds": 300 } โดย user_session_delay_seconds คือจำนวนวินาทีที่รอก่อนที่จะรีบูตอุปกรณ์หากผู้ใช้ลงชื่อเข้าใช้อยู่ ต้องเป็นจํานวนเต็มในช่วง [0,300] เมื่อไม่มีเพย์โหลดสำหรับการรีบูต ระบบจะใช้การหน่วงเวลา 0 เป็นค่าเริ่มต้น หมายเหตุ: การดำเนินการนี้จะมีผลเฉพาะในกรณีที่ผู้ใช้จริงเข้าสู่ระบบอยู่ ซึ่งรวมถึงผู้มาเยือน หากอุปกรณ์อยู่ในหน้าจอการเข้าสู่ระบบหรืออยู่ในโหมดคีออสก์ ระบบจะไม่ใช้ค่าดังกล่าวและรีบูตอุปกรณ์ทันที
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), ข้อมูลการแก้ไขข้อบกพร่องของ NIC ของ Intel WiFi (7), เหตุการณ์การสัมผัส (8), Lacros (9), ข้อมูลระบบ Lacros (10), บันทึก Flex ของ ChromeOS (11), รายละเอียด DBus (12), เส้นทางเครือข่ายของ ChromeOS (13), บันทึก Shill (ตัวจัดการการเชื่อมต่อ) ของ ChromeOS (14), นโยบาย (15), สถานะและบันทึกของระบบ ChromeOS (16), บันทึกของระบบ ChromeOS (17), บันทึกผู้ใช้ ChromeOS ของ Chrome (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

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