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_PACKETdata_collector_enumsdata_collector_enums

    פרטים נוספים זמינים במאמר העזרה.

גוף התשובה

תגובה להרצת פקודה.

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

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

string (int64 format)

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

היקפי ההרשאות

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

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

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