Method: chromeosdevices.action

הפריט הזה הוצא משימוש.

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

אזהרה:

• ביטול ההקצאה של מכשיר יגרום להפסקת הסנכרון של מדיניות המכשיר ולהסרת המדפסות ברמת המכשיר. לאחר ביטול ניהול ההקצאות של מכשיר, יש למחוק אותו לפני שניתן יהיה לרשום אותו מחדש.
• יש להפעיל את פעולת ההשבתה במכשירים שאבדו או נגנבו.
• הפעלה מחדש של מכשיר מושבת צורכת רישיון למכשיר. אם אין לך מספיק רישיונות זמינים לאחר השלמת פעולת ההפעלה מחדש, תתקבל הודעת שגיאה.
  מידע נוסף על ביטול של ניהול הקצאות והשבתה של מכשירים זמין במרכז העזרה.

בקשת 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 מוחזרים בתגובה מ-method 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 הוא מסך שמודיע לו שהמכשיר הושבת, ושצריך למלא את הפרטים הרצויים ליצירת קשר לגבי המקום שבו יש להחזיר את המכשיר. הערה: צריך להשלים את הגדרת ההודעה שתופיע במכשיר מושבת במסוף Admin. reenable: הפעלה מחדש של מכשיר מושבת כאשר נמצא מכשיר שאבד או כשהוא מוחזר למכשיר שאבד. אפשר להשתמש בתכונה הזו גם אם סימנתם בטעות מכשיר Chrome כמושבת. הערה: פעולת ההפעלה מחדש יכולה להתבצע רק במכשירים שסומנו כמושבתים. pre_provisioned_disable: מכשיר שהוקצה מראש ולא ניתן לרשום אותו. מנהל מערכת יכול להפעיל מחדש את המכשיר כדי לאפשר הרשמה דרך הארגון. כדי לעשות זאת, יש לשנות את הסטטוס ל-"pre_provisioned_reenable". הערה: מהמצב הזה, אפשר לבטל את ניהול ההקצאות של המכשיר. pre_provisioned_reenable: המכשיר סופק מראש על ידי יצרני ציוד מקורי (OEM). מכשירים במצב הזה זכאים להרשמה דרך הארגון.
deprovisionReason	string הערך הזה משמש רק כאשר הפעולה הזו מבטלת את ניהול ההקצאות. במקרה של פעולת הביטול של ניהול ההקצאות, השדה הזה הוא שדה חובה. הערה: הסיבה לביטול של ניהול ההקצאות נבדקת כי עשויות להיות לה השלכות על רישיונות ללקוחות שיש להם מינוי קבוע. הערכים הקבילים הם: different_model_replacement: יש להשתמש באפשרות הזו אם אתם משדרגים או מחליפים את המכשיר בדגם חדש יותר של אותו מכשיר. retiring_device: יש להשתמש במאפיין הזה אם אתם מפיצים או תורמים או מסירים את המכשיר באופן סופי משימוש. same_model_replacement: יש להשתמש באפשרות הזו אם אירעה בעיה בחומרה במכשיר והוא מוחלף באותו דגם או בהחלפה דומה לדגם של ספק או יצרן. upgrade_transfer: יש להשתמש באפשרות הזו אם אתם מחליפים את מכשירי ה-Chromebook שמוכנים לענן ב-Chromebook תוך שנה.