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

המטען הייעודי (payload) של הפקודה, צריך לספק אותו רק אם הוא תומך בכך. הפקודות הבאות תומכות בהוספת מטען ייעודי (payload):

  • SET_VOLUME: מטען ייעודי (payload) הוא אובייקט JSON ממחרוזת בפורמט: { "volume": 50 }. הנפח צריך להיות מספר שלם בטווח [0,100].
  • DEVICE_START_CRD_SESSION: מטען ייעודי (payload) הוא באופן אופציונלי אובייקט JSON עם מחרוזת בפורמט: { "ackedUserPresence": true }. הערך ackedUserPresence הוא בוליאני. ערך ברירת המחדל של ackedUserPresence הוא false. כדי להתחיל סשן של Chrome Remote Desktop במכשיר פעיל, צריך להגדיר את ackedUserPresence לערך true.
  • REBOOT: מטען ייעודי (payload) הוא אובייקט JSON בפורמט מחרוזת בפורמט הבא: { "user_session_delay_seconds": 300 }. ההשהיה צריכה להיות בטווח של [0, 300].
  • FETCH_SUPPORT_PACKET: מטען ייעודי (payload) הוא אובייקט עם מחרוזות JSON (ChromeOS2 (VPC1 Logs Logs (ChromeOS (ChromeOS5 Logs ), (ChromeOS1 (נתוני מערכת של ChromeOS Flex (ChromeOS (ChromeOS4 Network Logs ), ChromeOS (ChromeOS5 (רכיבי שפה במערכת של ChromeOS), ChromeOS (ChromeOS4 (נתוני מערכת של ChromeOS (ChromeOS (ChromeOS (ChromeOS5 (רכיבי לוג בשם ) , ChromeOS (ChromeOSD (רכיבי ChromoID של מערכת ChromeOS), ChromeOS (ChromeOS1 Logs Logs ), {"supportPacket":{ "issueCaseId": { "issueCaseId": Optional_support_case_id_string, "requestedDataCollectors": [<רשימת ערכים מופרדים בפסיקים של data_collector_enums ערכים של מספרים שלמים ב-Chrome (1),}
    רשימת הפריטים הזמינים data_collector_enums מופיעה:
    לפרטים נוספים אפשר לעיין במאמר העזרה.

גוף התשובה

תשובה על ביצוע פקודה.

אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "commandId": string
}
שדות
commandId

string (int64 format)

המזהה הייחודי של הפקודה שהונפקה, המשמש לאחזור סטטוס הפקודה.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, עיינו במדריך ההרשאות.