REST Resource: customer.devices.chromeos.commands

ทรัพยากร: DirectoryChromeosdevicesCommand

ข้อมูลเกี่ยวกับคำสั่งที่ออกให้กับอุปกรณ์

การแสดง JSON 
{
  "commandId": string,
  "type": enum (CommandType),
  "issueTime": string,
  "state": enum (State),
  "commandExpireTime": string,
  "commandResult": {
    object (DirectoryChromeosdevicesCommandResult)
  },
  "payload": string
}
ช่อง
commandId

string (int64 format)

รหัสที่ไม่ซ้ำกันของคำสั่งอุปกรณ์
type

enum (CommandType)

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

string (Timestamp format)

การประทับเวลาที่ผู้ดูแลระบบออกคำสั่ง

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
state

enum (State)

ระบุสถานะคําสั่ง
commandExpireTime

string (Timestamp format)

เวลาที่คำสั่งจะหมดอายุ หากอุปกรณ์ไม่เรียกใช้คำสั่งภายในช่วงเวลาดังกล่าว คำสั่งดังกล่าวจะหมดอายุ

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
commandResult

object (DirectoryChromeosdevicesCommandResult)

ผลของการดำเนินการตามคำสั่ง
payload

string

เพย์โหลดที่คำสั่งระบุไว้ หากมี

CommandType

กำหนดประเภทคำสั่งที่อุปกรณ์จะต้องดำเนินการ

Enum
COMMAND_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทคำสั่ง
REBOOT รีบูตอุปกรณ์ ออกให้กับคีออสก์และอุปกรณ์เซสชันผู้เยี่ยมชมที่มีการจัดการได้เท่านั้น
TAKE_A_SCREENSHOT จับภาพหน้าจอของอุปกรณ์ ใช้ได้เฉพาะเมื่ออุปกรณ์อยู่ในโหมดคีออสก์เท่านั้น
SET_VOLUME ตั้งระดับเสียงของอุปกรณ์ ออกให้กับคีออสก์และอุปกรณ์เซสชันผู้เยี่ยมชมที่มีการจัดการได้เท่านั้น
WIPE_USERS ล้างข้อมูลผู้ใช้ทั้งหมดออกจากอุปกรณ์ การเรียกใช้คำสั่งนี้ในอุปกรณ์จะนำข้อมูลโปรไฟล์ผู้ใช้ทั้งหมดออก แต่จะยังคงใช้นโยบายด้านอุปกรณ์และการลงทะเบียนต่อไป
REMOTE_POWERWASH ล้างข้อมูลอุปกรณ์โดยทำการ Powerwash การเรียกใช้คำสั่งนี้ในอุปกรณ์จะนำข้อมูลทั้งหมดออก ซึ่งรวมถึงนโยบายผู้ใช้ นโยบายอุปกรณ์ และนโยบายการลงทะเบียน คำเตือน: การตั้งค่านี้จะเปลี่ยนอุปกรณ์กลับไปเป็นค่าเริ่มต้นเหมือนยังไม่เคยลงทะเบียนมาก่อน เว้นแต่อุปกรณ์จะอยู่ภายใต้การลงทะเบียนแบบบังคับหรือการลงทะเบียนอัตโนมัติ โปรดใช้ด้วยความระมัดระวัง เนื่องจากเป็นการดำเนินการที่ย้อนกลับไม่ได้
DEVICE_START_CRD_SESSION เริ่มเซสชัน Chrome Remote Desktop
CAPTURE_LOGS เก็บบันทึกระบบของอุปกรณ์คีออสก์ คุณสามารถดาวน์โหลดบันทึกได้จากลิงก์ DownloadUrl ที่อยู่ในช่อง deviceFiles ของ chromeosdevices
FETCH_SUPPORT_PACKET ดึงข้อมูลแพ็กเก็ตการสนับสนุนจากอุปกรณ์จากระยะไกล แพ็กเก็ตการสนับสนุนคือที่เก็บถาวรแบบ Zip ที่มีบันทึกของระบบและข้อมูลการแก้ไขข้อบกพร่องต่างๆ จากอุปกรณ์ ChromeOS คุณสามารถดาวน์โหลดแพ็กเก็ตการสนับสนุนได้จากลิงก์ DownloadURL ที่อยู่ในช่อง deviceFiles ของ chromeosdevices

รัฐ

แสดงสถานะของคำสั่งที่ออก

Enum
STATE_UNSPECIFIED ไม่ได้ระบุสถานะคําสั่ง
PENDING ยังไม่ได้ส่งคำสั่งที่ยังไม่หมดอายุไปยังไคลเอ็นต์
EXPIRED ไคลเอ็นต์ไม่ได้เรียกใช้คำสั่งภายในเวลาที่คาดไว้
CANCELLED ผู้ดูแลระบบยกเลิกคำสั่งขณะรอดำเนินการ
SENT_TO_CLIENT ส่งคำสั่งไปยังไคลเอ็นต์แล้ว
ACKED_BY_CLIENT ไคลเอ็นต์ตอบกลับว่าได้รับคำสั่งแล้ว
EXECUTED_BY_CLIENT ไคลเอ็นต์เรียกใช้คำสั่ง (ไม่สำเร็จ)

DirectoryChromeosdevicesCommandResult

ผลของการเรียกใช้คำสั่ง

การแสดง JSON 
{
  "result": enum (CommandResultType),
  "executeTime": string,
  "errorMessage": string,
  "commandResultPayload": string
}
ช่อง
result

enum (CommandResultType)

ผลลัพธ์ของคำสั่ง
executeTime

string (Timestamp format)

เวลาที่คำสั่งถูกเรียกใช้งานหรือการดำเนินการล้มเหลว

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขที่เป็นเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
errorMessage

string

ข้อความแสดงข้อผิดพลาดพร้อมคำอธิบายสั้นๆ ถึงสาเหตุที่คําสั่งล้มเหลว แสดงเมื่อคำสั่งล้มเหลวเท่านั้น
commandResultPayload

string

เพย์โหลดสำหรับผลลัพธ์คำสั่ง คำสั่งต่อไปนี้จะตอบสนองด้วยเพย์โหลด

  • DEVICE_START_CRD_SESSION: เพย์โหลดคือออบเจ็กต์ JSON ที่มีรูปแบบเป็นสตริงในรูปแบบ { "url": url } โดย URL ดังกล่าวจะมีลิงก์ไปยังเซสชัน Chrome Remote Desktop

CommandResultType

ประเภทของผลลัพธ์คำสั่ง

Enum
COMMAND_RESULT_TYPE_UNSPECIFIED ไม่ได้ระบุผลลัพธ์ของคำสั่ง
IGNORED คำสั่งนี้ถูกข้ามว่าล้าสมัย
FAILURE ดำเนินการคำสั่งไม่สำเร็จ
SUCCESS เรียกใช้คำสั่งเรียบร้อยแล้ว

วิธีการ

get

 รับข้อมูลคำสั่งตามคำสั่งเฉพาะที่ออกให้กับอุปกรณ์