שינוי הסטטוס של קבוצת מכשירי ChromeOS. מידע נוסף על שינוי המצב של מכשירי ChromeOS תיקון, שינוי הייעוד של מכשירי ChromeOS או הוצאה משימוש של מכשירי ChromeOS
בקשת HTTP
POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos:batchChangeStatus
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
customerId |
חובה. המזהה לא משתנה של חשבון Google Workspace. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "deviceIds": [ string ], "changeChromeOsDeviceStatusAction": enum ( |
שדות | |
---|---|
deviceIds[] |
חובה. רשימת המזהים של מכשירי ChromeOS שצריך לשנות. עד 50. |
changeChromeOsDeviceStatusAction |
חובה. הפעולה שצריך לבצע במכשיר ChromeOS כדי לשנות את הסטטוס שלו. |
deprovisionReason |
אפשרות. הסיבה לביטול של ניהול ההקצאות במכשיר. חובה לציין אם הערך 'changeChromeOsDeviceStatusAction' מוגדר כ-'CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION'. אחרת, יש להשמיט את השדה הזה. |
גוף התשובה
התגובה לשינוי הסטטוס של קבוצת מכשירי ChromeOS.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{
"changeChromeOsDeviceStatusResults": [
{
object ( |
שדות | |
---|---|
changeChromeOsDeviceStatusResults[] |
התוצאות של כל אחד ממכשירי 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 |
שדות | |
---|---|
deviceId |
המזהה הייחודי של מכשיר ChromeOS. |
שדה איחוד הערך של |
|
error |
תוצאת השגיאה של הפעולה במקרה של כשל. |
response |
סטטוס המכשיר יכול לשנות את הסטטוס שלו. |
סטטוס
הסוג Status
מגדיר מודל שגיאה לוגית שמתאים לסביבות תכנות שונות, כולל ממשקי REST API ו-RPC API. הוא משמש את gRPC. כל הודעת Status
מכילה שלושה קטעי נתונים: קוד שגיאה, הודעת שגיאה ופרטי שגיאה.
מידע נוסף על מודל השגיאה הזה והסבר על השימוש בו זמין במדריך לעיצוב API.
ייצוג JSON |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
שדות | |
---|---|
code |
קוד הסטטוס, שצריך להיות ערך 'טיפוסים בני מנייה (enum)' |
message |
הודעת שגיאה למפתחים, שאמורה להיות באנגלית. כל הודעת שגיאה שמוצגת למשתמש צריכה להיות מותאמת לשוק המקומי ולשלוח אותה בשדה |
details[] |
רשימת ההודעות עם פרטי השגיאה. יש קבוצה משותפת של סוגי הודעות שבהם אפשר להשתמש בממשקי API. אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף |
ChangeChromeOsDeviceStatusSucceeded
אין שדות בסוג הזה.
תגובה לשינוי מוצלח בסטטוס של מכשיר ChromeOS.