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)

الطابع الزمني لوقت إصدار المشرف للأمر

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
state

enum (State)

يشير إلى حالة الطلب.
commandExpireTime

string (Timestamp format)

الوقت الذي ستنتهي فيه صلاحية الأمر إذا لم ينفذ الجهاز الأمر خلال هذه الفترة، ستنتهي صلاحيته.

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
commandResult

object (DirectoryChromeosdevicesCommandResult)

نتيجة تنفيذ الأمر
payload

string

الحمولة التي حدّدها الأمر، إن وُجدت

CommandType

لتحديد نوع الأمر الذي يجب أن ينفذه الجهاز.

عمليات التعداد
COMMAND_TYPE_UNSPECIFIED لم يتم تحديد نوع الطلب.
REBOOT أعِد تشغيل الجهاز. يمكن إصدارها لأجهزة وضع Kiosk وجلسات الضيوف المُدارة والأجهزة العادية التي تعمل بالإصدار 113 من ChromeOS أو إصدار أحدث.
TAKE_A_SCREENSHOT التقط لقطة شاشة للجهاز. لا تتوفّر هذه الميزة إلا إذا كان الجهاز في وضع Kiosk.
SET_VOLUME اضبط مستوى صوت الجهاز. لا يمكن إصدارها إلا لأجهزة Kiosk وجلسات الضيف المُدارة.
WIPE_USERS امسح بيانات جميع المستخدمين من الجهاز. سيؤدي تنفيذ هذا الأمر في الجهاز إلى إزالة جميع بيانات الملف الشخصي للمستخدم، ولكن سيحتفظ بسياسة الجهاز وتسجيله.
REMOTE_POWERWASH يؤدي هذا الأمر إلى محو بيانات الجهاز من خلال إجراء عملية محو بيانات الجهاز. سيؤدي تنفيذ هذا الأمر في الجهاز إلى إزالة جميع البيانات، بما في ذلك سياسات المستخدمين وسياسات الجهاز وسياسات التسجيل. تحذير: سيؤدي هذا الإجراء إلى إعادة الجهاز إلى حالته الأصلية بدون تسجيل، إلا إذا كان الجهاز خاضعًا لإعادة التسجيل الإلزامية أو التلقائية. يُرجى استخدام هذا الخيار بحذر، لأنّه لا يمكن التراجع عن هذا الإجراء.
DEVICE_START_CRD_SESSION بدء جلسة "الوصول إلى الكمبيوتر المكتبي عن بُعد من Chrome"
CAPTURE_LOGS تسجيل سجلّات النظام لجهاز Kiosk يمكن تنزيل السجلات من رابط downloadUrl المتوفّر في حقل deviceFiles من chromeosdevices.
FETCH_CRD_AVAILABILITY_INFO تُستخدَم هذه البطاقة لجلب المعلومات التي تحدِّد مدى توفّر تطبيق "سطح المكتب البعيد من Chrome" على الجهاز.
FETCH_SUPPORT_PACKET جلب حزمة الدعم من جهاز عن بُعد حزمة الدعم هي أرشيف مضغوط بتنسيق zip يحتوي على سجلات نظام وبيانات تصحيح أخطاء مختلفة من جهاز ChromeOS. يمكن تنزيل حزمة الدعم من رابط downloadURL المتوفّر في حقل deviceFiles في chromeosdevices.

الحالة

تمثّل حالة الأمر الصادر.

عمليات التعداد
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)

الوقت الذي تم فيه تنفيذ الأمر أو تعذّر تنفيذه.

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
errorMessage

string

رسالة الخطأ مع شرح موجز لسبب تعذُّر تنفيذ الأمر لا يظهر هذا الحقل إلّا إذا تعذّر تنفيذ الأمر.
commandResultPayload

string

الحمولة لنتيجة الأمر تستجيب الأوامر التالية بحمولة:

  • DEVICE_START_CRD_SESSION: الحمولة هي عنصر JSON تم تحويله إلى سلسلة بالتنسيق: { "url": url }. يقدّم عنوان URL رابطًا إلى جلسة Chrome Remote Desktop.

CommandResultType

نوع نتيجة الأمر

عمليات التعداد
COMMAND_RESULT_TYPE_UNSPECIFIED لم يتم تحديد نتيجة الأمر.
IGNORED تم تجاهل الأمر لأنّه قديم.
FAILURE تعذّر تنفيذ الأمر بنجاح.
SUCCESS تم تنفيذ الأمر بنجاح.

الطُرق

get

 تحصل على بيانات الأمر، وهو أمر محدّد تم إصداره إلى الجهاز.