Method: chromeosdevices.action

במקום זאת, צריך להשתמש ב-BatchChangeChromeOsDeviceStatus. ביצוע פעולה שמשפיעה על מכשיר Chrome OS. הנתון הזה כולל הסרה של הקצאה, השבתה והפעלה מחדש של מכשירים.

בקשת HTTP

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

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

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

פרמטרים
customerId

string

המזהה הייחודי של חשבון Google Workspace של הלקוח. כמנהל חשבון, יש לך אפשרות להשתמש בכינוי my_customer גם כדי לייצג את customerId של החשבון שלך. הערך customerId מוחזר גם כחלק ממשאב המשתמשים.
resourceId

string

המזהה הייחודי של המכשיר. הערכים של resourceId מוחזרים בתגובה מהשיטה chromeosdevices.list.

גוף הבקשה

גוף הבקשה מכיל מופע של ChromeOsDeviceAction.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, התשובה היא תגובה גנרית של HTTP שהפורמט שלה מוגדר על ידי השיטה.

היקפי הרשאה

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

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

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

ChromeOsDeviceAction

נתונים על עדכון לסטטוס של מכשיר Chrome OS.

ייצוג ב-JSON 
{
  "action": string,
  "deprovisionReason": string
}
שדות
action

string

chromeosdevices.action שיבוצע במכשיר ChromeOS.

הערכים הקבילים הם:

  • deprovision: כדי להסיר מכשיר מהניהול שכבר לא פעיל, שכבר מופץ או נשלח לבדיקה מחדש, או שנשלח לתיקון או להחזרה, יש להשתמש בפעולת הביטול של ניהול ההקצאות כדי לבטל את השיוך שלו לניהול.
  • disable: אם לדעתכם מכשיר בארגון אבד או נגנב, אתם יכולים להשבית אותו כדי שאף אחד אחר לא יוכל להשתמש בו. כשמכשיר מושבת, כל מה שהמשתמש יכול לראות כשמפעילים את מכשיר Chrome הוא מסך עם הודעה על כך שהמכשיר הושבת, ואת פרטי הקשר שלכם לצורך החזרת המכשיר.
  • reenable: הפעלה מחדש של מכשיר מושבת כשמוצאים מכשיר שהיה במקום לא נכון או כשמקבלים בחזרה מכשיר שאבד. אפשר להשתמש בתכונה הזו גם אם מסמנים בטעות מכשיר Chrome כמושבת.
  • pre_provisioned_disable: מכשיר שהוקצה מראש ולא ניתן לרשום אותו. אדמין יכול להפעיל מחדש את המכשיר ולאפשר הרשמה דרך הארגון על ידי שינוי הסטטוס ל-'pre_provisioned_reenable'. הערה: במצב הזה אפשר לבטל את ניהול ההקצאות של המכשיר.
  • pre_provisioned_reenable: המכשיר הוקצה מראש על ידי יצרני ציוד מקורי. מכשירים במצב הזה עומדים בדרישות להרשמה דרך הארגון.
deprovisionReason

string

משמש רק כשהפעולה היא ביטול ההקצאה. בשדה הזה צריך לציין את שם המשתמש.

הערכים הקבילים הם:

  • different_model_replacement: יש להשתמש באפשרות הזו אם משדרגים או מחליפים את המכשיר בדגם חדש יותר של אותו מכשיר.
  • retiring_device: משתמשים באפשרות הזו אם רוצים למכור מחדש, לתרום או להסיר את המכשיר לתמיד.
  • same_model_replacement: משתמשים באפשרות הזו אם נתקלת בבעיית חומרה במכשיר והוא הוחלף באותו דגם או בדגם דומה על ידי ספק תיקונים או יצרן.
  • upgrade_transfer: משתמשים באפשרות הזו אם רוצים להחליף את מכשירי Cloud Ready במכשירי Chromebook תוך שנה.