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 }. ackedUserPresence هي قيمة منطقية. بشكل تلقائي، يتم ضبط ackedUserPresence على false. لبدء جلسة على "سطح المكتب البعيد من Chrome" على جهاز نشط، عليك ضبط ackedUserPresence على true.
  • REBOOT: الحمولة هي عنصر JSON تم تحويله إلى سلسلة نصية بالتنسيق: { "user_session_delay_seconds": 300 }. يجب أن يكون التأخير في النطاق [0، 300].
  • FETCH_SUPPORT_PACKET: حمولة البيانات الأساسية (Payloads) هي عنصر JSON تم إنشاؤه بتنسيق JSON (بيانات نظام التشغيل ChromeOS (GPU)) (على سبيل المثال لا الحصر ChromeOS) (بيانات ChromeOS (معرّف الجهاز الافتراضي)) على النحو التالي: {"supportPacketDetails":{ "issueCaseId":OPTIONAL_support_case_id_string, "issueDescription":OPTIONAL_issue_description_string, "requestedDataCollectors", "requestedDataCollectors": [<comma-Separate list of data_collector_enums integer settings>]}}
    قائمة بيانات data_collector_enums المتوفرة (نظام التشغيل ChromeOS (cromp1) (Chrome RouteManager الإضافية (نظام التشغيل ChromeOS) 201) ({"supportPacketDetails") ({"supportPacketDetails"? )
    يمكنك الاطّلاع على مزيد من التفاصيل في مقالة المساعدة.

نص الاستجابة

يشير ذلك المصطلح إلى استجابة لإصدار أمر.

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

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

string (int64 format)

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

نطاقات التفويض

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

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

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