Method: customer.devices.chromeos.batchChangeStatus

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת 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.

טיפוסים בני מנייה (enums)
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 מגדיר מודל שגיאה לוגית שמתאים לסביבות תכנות שונות, כולל ממשקי REST API ו-RPC API. הוא משמש את 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.