Method: chromeosdevices.action

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
customerId

string

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

resourceId

string

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

גוף הבקשה

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

גוף התשובה

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

היקפי ההרשאות

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

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

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

ChromeOsDeviceAction

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

ייצוג 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: יש לך אפשרות להשתמש באפשרות הזו אם ברצונך להחליף מכשירים שמותאמות לענן במכשירי Chromebook תוך שנה אחת.