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

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

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

string

chromeosdevices.action שצריך לבצע במכשיר Chrome OS.

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

  • 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 תוך שנה.