Method: customer.devices.chromeos.issueCommand

دستوری را برای دستگاه صادر می کند تا اجرا شود.

درخواست HTTP

POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}:issueCommand

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
customerId

string

تغییرناپذیر. شناسه حساب Google Workspace.

deviceId

string

تغییرناپذیر. شناسه دستگاه سیستم عامل Chrome.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "commandType": enum (CommandType),
  "payload": string
}
فیلدها
commandType

enum ( CommandType )

نوع فرمان.

payload

string

محموله برای دستور، آن را فقط در صورتی ارائه کنید که فرمان از آن پشتیبانی کند. دستورات زیر از اضافه کردن بار پشتیبانی می‌کنند:

  • SET_VOLUME : Payload یک شیء JSON رشته ای است به شکل: { "volume": 50 }. حجم باید یک عدد صحیح در محدوده [0,100] باشد.
  • DEVICE_START_CRD_SESSION : Payload به صورت اختیاری یک شیء JSON رشته‌دار به شکل است: { "ackedUserPresence": true، "crdSessionType": string }. ackedUserPresence یک بولی است. به طور پیش فرض، ackedUserPresence روی false تنظیم شده است. برای شروع یک جلسه دسک‌تاپ از راه دور Chrome برای یک دستگاه فعال، ackedUserPresence روی true تنظیم کنید. crdSessionType فقط می‌تواند از بین مقادیر private (که کنترل انحصاری دستگاه ChromeOS را به سرپرست راه دور می‌دهد) یا shared (که به سرپرست و کاربر محلی امکان می‌دهد کنترل دستگاه ChromeOS را به اشتراک بگذارند) انتخاب کند. اگر تنظیم نشده باشد، crdSessionType به طور پیش‌فرض به shared می‌شود.
  • REBOOT : Payload یک شیء JSON رشته‌ای است به شکل: { "user_session_delay_seconds": 300 }. user_session_delay_seconds مقدار ثانیه‌ای است که باید قبل از راه‌اندازی مجدد دستگاه در صورت ورود کاربر به سیستم منتظر بمانید. این عدد باید یک عدد صحیح در محدوده [0,300] باشد. هنگامی که بار برای راه اندازی مجدد وجود ندارد، 0 تاخیر پیش فرض است. توجه: این فقط در صورتی اعمال می شود که یک کاربر واقعی از جمله یک مهمان وارد شده باشد. اگر دستگاه در صفحه ورود به سیستم یا در حالت کیوسک باشد، مقدار آن رعایت نمی شود و دستگاه بلافاصله راه اندازی مجدد می شود.
  • FETCH_SUPPORT_PACKET : Payload به data_collector_enums اختیاری یک شیء JSON رشته‌دار است به این شکل: {"supportPacketDetails":{ "issueCaseId": optional_support_case_id_string، "issueDescription": optional_issue_description_string، "requestedDataCollectors ofma_separated": مقادیر>]}}
    فهرست data_collector_enums موجود به شرح زیر است: اطلاعات سیستم Chrome (1)، شناسه‌های خرابی (2)، جزئیات حافظه (3)، سلسله‌مراتب رابط کاربری (4)، گزارش‌های پلتفرم ChromeOS اضافی (5)، رویداد دستگاه (6)، حذف اشکال‌زدایی کارت‌های WiFi Intel (7)، رویدادهای لمسی (8)، Lacros (10B)، اطلاعات سیستم Chrome (10B)، اطلاعات سیستم Chrome (10B) جزئیات (12)، مسیرهای شبکه ChromeOS (13)، گزارش‌های ChromeOS Shill (مدیر اتصال) (14)، خط‌مشی‌ها (15)، وضعیت سیستم ChromeOS و گزارش‌ها (16)، گزارش‌های سیستم ChromeOS (17)، گزارش‌های کاربر ChromeOS Chrome (18)، ChromeOS بلوتوث (19)، دستگاه‌های ورودی متصل ChromeOS (20)، ChromeOS2rt Keyboard Co. (23).
    جزئیات بیشتر را در مقاله راهنما ببینید.

بدن پاسخگو

پاسخی برای صدور فرمان.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "commandId": string
}
فیلدها
commandId

string ( int64 format)

شناسه منحصر به فرد فرمان صادر شده که برای بازیابی وضعیت فرمان استفاده می شود.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.