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. لا يمكن لـ crdSessionType الاختيار إلا من بين القيمتَين private (التي تمنح المشرف عن بُعد إمكانية التحكّم الحصري في جهاز ChromeOS) أو shared (التي تسمح للمشرف والمستخدم المحلي بمشاركة التحكّم في جهاز ChromeOS). إذا لم يتم ضبط القيمة، تكون القيمة التلقائية لسمة crdSessionType هي shared.
  • 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)، تجميع أخطاء Intel WiFi NIC (7)، أحداث اللمس (8)، Lacros (9)، معلومات نظام Lacros (10)، سجلات ChromeOS Flex (11)، تفاصيل DBus (12)، مسارات شبكة ChromeOS (13)، سجلات ChromeOS Shill (مدير الربط) (14)، السياسات (15)، حالة نظام ChromeOS وسجلاته (16)، سجلات نظام ChromeOS (17)، سجلات مستخدم ChromeOS على ChromeOS (18)، بلوتوث 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

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