Method: customer.devices.chromeos.batchChangeStatus

שינוי הסטטוס של קבוצה של מכשירי ChromeOS. מידע נוסף על שינוי הסטטוס של מכשיר ChromeOS זמין במאמר תיקון, שימוש חוזר או הוצאה משימוש של מכשירי ChromeOS.

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של נתיב

פרמטרים
customerId

string

חובה. מזהה קבוע של חשבון Google Workspace.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "deviceIds": [
    string
  ],
  "changeChromeOsDeviceStatusAction": enum (ChangeChromeOsDeviceStatusAction),
  "deprovisionReason": enum (DeprovisionReason)
}
שדות
deviceIds[]

string

חובה. רשימת המזהים של מכשירי ChromeOS שרוצים לשנות. מקסימום 50.
changeChromeOsDeviceStatusAction

enum (ChangeChromeOsDeviceStatusAction)

חובה. הפעולה שצריך לבצע במכשיר ChromeOS כדי לשנות את הסטטוס שלו.
deprovisionReason

enum (DeprovisionReason)

זה שינוי אופציונלי. הסיבה לביטול ההקצאה של המכשיר. צריך לציין את השדה הזה אם השדה changeChromeOsDeviceStatusAction מוגדר כ-CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION. אחרת, משמיטים את השדה הזה.

גוף התשובה

התגובה לשינוי הסטטוס של קבוצה של מכשירי ChromeOS.

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

ייצוג ב-JSON 
{
  "changeChromeOsDeviceStatusResults": [
    {
      object (ChangeChromeOsDeviceStatusResult)
    }
  ]
}
שדות
changeChromeOsDeviceStatusResults[]

object (ChangeChromeOsDeviceStatusResult)

התוצאות לכל אחד ממכשירי ChromeOS שצוינו בבקשה.

היקפי הרשאה

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

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

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

ChangeChromeOsDeviceStatusAction

הפעולה שצריך לבצע כדי לשנות את הסטטוס של מכשיר ChromeOS.

טיפוסים בני מנייה (enum)
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_UNSPECIFIED ערך ברירת המחדל. הערך לא בשימוש.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION ביטול ההקצאה של מכשיר ChromeOS. אם יש לכם מכשירי ChromeOS שכבר לא נמצאים בשימוש בארגון, עליכם לבטל את ניהול ההקצאות שלהם כדי לא לנהל אותם יותר. אם מבטלים את ניהול ההקצאות של המכשיר, כל כללי המדיניות שהיו במכשיר יוסרו, כולל מדפסות ברמת המכשיר והאפשרות להשתמש במכשיר כקיוסק. בהתאם לשדרוג שמשויך למכשיר, הפעולה הזו עשויה להחזיר את הרישיון למאגר הרישיונות, וכך תהיה לכם אפשרות להשתמש ברישיון במכשיר אחר.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE השבתת מכשיר ChromeOS. משתמשים בפעולה הזו אם משתמש מאבד את המכשיר או אם הוא נגנב. כך המכשיר עדיין מנוהל, ולכן עדיין יקבל מדיניות, אבל אף אחד לא יוכל להשתמש בו. בהתאם לשדרוג שמשויך למכשיר, הפעולה הזו עשויה לשחרר את הרישיון בחזרה למאגר הרישיונות, וכך תהיה לכם אפשרות להשתמש ברישיון במכשיר אחר.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_REENABLE הפעלה מחדש של מכשיר ChromeOS לשימוש אחרי השבתה. הפעלה מחדש של המכשיר אחרי שהוא לא אבד יותר או אחרי שהוא שוחזר. כך תוכלו להשתמש שוב במכשיר. בהתאם לשדרוג שמשויך למכשיר, הפעולה הזו עשויה לצרוך רישיון אחד ממאגר הרישיונות. כלומר, אם אין מספיק רישיונות זמינים, הפעולה תיכשל.

ChangeChromeOsDeviceStatusResult

התוצאה של מכשיר ChromeOS יחיד עבור פעולת שינוי מצב.

ייצוג ב-JSON 
{
  "deviceId": string,

  // Union field result can be only one of the following:
  "error": {
    object (Status)
  },
  "response": {
    object (ChangeChromeOsDeviceStatusSucceeded)
  }
  // End of list of possible types for union field result.
}
שדות
deviceId

string

המזהה הייחודי של מכשיר ChromeOS.

שדה האיחוד result.

הערך של result יכול להיות רק אחת מהאפשרויות הבאות:
error

object (Status)

תוצאת השגיאה של הפעולה במקרה של כשל.
response

object (ChangeChromeOsDeviceStatusSucceeded)

הסטטוס של המכשיר השתנה בהצלחה.

סטטוס

הסוג Status מגדיר מודל שגיאה לוגי שמתאים לסביבות תכנות שונות, כולל ממשקי API ל-REST וממשקי API ל-RPC. הוא משמש את gRPC. כל הודעה מסוג Status מכילה שלושה נתונים: קוד שגיאה, הודעת שגיאה ופרטי השגיאה.

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

ייצוג ב-JSON 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
שדות
code

integer

קוד הסטטוס, שצריך להיות ערך enum של google.rpc.Code.
message

string

הודעת שגיאה למפתחים, שצריכה להיות באנגלית. כל הודעת שגיאה שמוצגת למשתמש צריכה להיות מותאמת לשוק המקומי ונשלחת בשדה google.rpc.Status.details, או שמותאמת על ידי הלקוח.
details[]

object

רשימה של הודעות שמכילות את פרטי השגיאה. יש קבוצה משותפת של סוגי הודעות שאפשר להשתמש בהם בממשקי API.

אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף "@type" מכיל URI שמזהה את הסוג. דוגמה: { "id": 1234, "@type": "types.example.com/standard/id" }.

ChangeChromeOsDeviceStatusSucceeded

אין שדות לסוג הזה.

תגובה לשינוי סטטוס מוצלח של מכשיר ChromeOS.