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_PACKETdata_collector_enumsdata_collector_enums

    يمكنك الاطّلاع على مزيد من التفاصيل في مقالة المساعدة.

نص الاستجابة

تمثّل هذه السمة استجابة لإصدار أمر.

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

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

string (int64 format)

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

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

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

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

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