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

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل 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" لجهاز نشط، اضبط ackedUserPresence على true. يمكنك اختيار القيمة private فقط (التي تمنح المشرف عن بُعد إذنًا حصريًا بالتحكّم في جهاز ChromeOS) أو shared (التي تسمح للمشرف والمستخدم المحلي بمشاركة التحكّم في جهاز ChromeOS).crdSessionType إذا لم يتم ضبطها، تكون القيمة التلقائية crdSessionType هي shared. يمكن استخدام الأمر FETCH_CRD_AVAILABILITY_INFO لتحديد أنواع الجلسات المتاحة على الجهاز.
  • REBOOT: الحمولة هي عنصر JSON محوَّل إلى سلسلة بالصيغة: { "user_session_delay_seconds": 300 }. user_session_delay_seconds هو عدد الثواني التي يجب الانتظار خلالها قبل إعادة تشغيل الجهاز إذا سجّل المستخدم الدخول. يجب أن تكون القيمة عددًا صحيحًا ضمن النطاق [0,300]. عندما لا تكون الحمولة متوفّرة لإعادة التشغيل، يكون التأخير التلقائي هو 0. ملاحظة: لا ينطبق هذا الإعداد إلا إذا سجّل مستخدم فعلي الدخول، بما في ذلك الضيف. إذا كان الجهاز في شاشة تسجيل الدخول أو في وضع Kiosk، لن يتم الالتزام بالقيمة وستتم إعادة تشغيل الجهاز على الفور.
  • 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)، التسلسل الهرمي لواجهة المستخدم (4)، سجلّات إضافية لمنصة ChromeOS‏ (5)، حدث الجهاز (6)، تفريغ تصحيح أخطاء بطاقات شبكة Wi-Fi من Intel‏ (7)، أحداث اللمس (8)، Lacros‏ (9)، معلومات نظام Lacros‏ (10)، سجلّات ChromeOS Flex‏ (11)، تفاصيل DBus‏ (12)، مسارات شبكة ChromeOS‏ (13)، سجلّات ChromeOS Shill‏ (14)، السياسات (15)، حالة نظام ChromeOS وسجلّاته (16)، سجلّات نظام ChromeOS‏ (17)، سجلّات مستخدم Chrome في ChromeOS‏ (18)، Bluetooth في ChromeOS‏ (19)، أجهزة الإدخال المتصلة في ChromeOS‏ (20)، عدّادات عدد الزيارات في ChromeOS‏ (21)، لوحة المفاتيح الافتراضية في ChromeOS‏ (22)، حالة الشبكة في ChromeOS‏ (23).
    يمكنك الاطّلاع على مزيد من التفاصيل في مقالة المساعدة.

نص الاستجابة

ردّ لإصدار أمر

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "commandId": string
}
الحقول
commandId

string (int64 format)

المعرّف الفريد للأمر الصادر، ويُستخدم لاسترداد حالة الأمر.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.