REST Resource: chromeosdevices

משאב: ChromeOsDevice

מכשירי Google Chrome פועלים עם Chrome OS. מידע נוסף על משימות נפוצות של ה-API זמין במדריך למפתחים.

ייצוג JSON 
{
  "deviceId": string,
  "serialNumber": string,
  "status": string,
  "lastSync": string,
  "supportEndDate": string,
  "annotatedUser": string,
  "annotatedLocation": string,
  "notes": string,
  "model": string,
  "meid": string,
  "orderNumber": string,
  "willAutoRenew": boolean,
  "osVersion": string,
  "platformVersion": string,
  "firmwareVersion": string,
  "macAddress": string,
  "bootMode": string,
  "lastEnrollmentTime": string,
  "kind": string,
  "recentUsers": [
    {
      "type": string,
      "email": string
    }
  ],
  "activeTimeRanges": [
    {
      "activeTime": integer,
      "date": string
    }
  ],
  "ethernetMacAddress": string,
  "annotatedAssetId": string,
  "etag": string,
  "diskVolumeReports": [
    {
      "volumeInfo": [
        {
          "volumeId": string,
          "storageTotal": string,
          "storageFree": string
        }
      ]
    }
  ],
  "systemRamTotal": string,
  "cpuStatusReports": [
    {
      "reportTime": string,
      "cpuUtilizationPercentageInfo": [
        integer
      ],
      "cpuTemperatureInfo": [
        {
          "temperature": integer,
          "label": string
        }
      ]
    }
  ],
  "cpuInfo": [
    {
      "model": string,
      "architecture": string,
      "maxClockSpeedKhz": integer,
      "logicalCpus": [
        {
          "maxScalingFrequencyKhz": integer,
          "currentScalingFrequencyKhz": integer,
          "idleDuration": string,
          "cStates": [
            {
              "displayName": string,
              "sessionDuration": string
            }
          ]
        }
      ]
    }
  ],
  "deviceFiles": [
    {
      "name": string,
      "type": string,
      "downloadUrl": string,
      "createTime": string
    }
  ],
  "systemRamFreeReports": [
    {
      "reportTime": string,
      "systemRamFreeInfo": [
        string
      ]
    }
  ],
  "lastKnownNetwork": [
    {
      "ipAddress": string,
      "wanIpAddress": string
    }
  ],
  "autoUpdateExpiration": string,
  "ethernetMacAddress0": string,
  "dockMacAddress": string,
  "manufactureDate": string,
  "orgUnitPath": string,
  "tpmVersionInfo": {
    "family": string,
    "specLevel": string,
    "manufacturer": string,
    "tpmModel": string,
    "firmwareVersion": string,
    "vendorSpecific": string
  },
  "screenshotFiles": [
    {
      "name": string,
      "type": string,
      "downloadUrl": string,
      "createTime": string
    }
  ],
  "orgUnitId": string,
  "osUpdateStatus": {
    object (OsUpdateStatus)
  },
  "firstEnrollmentTime": string,
  "lastDeprovisionTimestamp": string,
  "deprovisionReason": enum (DeprovisionReason),
  "deviceLicenseType": enum (DeviceLicenseType),
  "backlightInfo": [
    {
      object (BacklightInfo)
    }
  ]
}
שדות
deviceId

string

המזהה הייחודי של מכשיר ה-Chrome.
serialNumber

string

המספר הסידורי של מכשיר ה-Chrome שהוזן כשהמכשיר הופעל. הערך הזה זהה למספר הסידורי של מסוף Admin בכרטיסייה מכשירי Chrome OS.
status

string

הסטטוס של המכשיר.

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

  • ACTIVE: המכשיר רשום לדומיין.
  • DELINQUENT: פג תוקף הרישיון השנתי של הדומיין והוא לא מקבל יותר כללי מדיניות והגדרות. לאחר רכישת רישיון חדש, המכשיר יחזור למצב ACTIVE.
  • PRE_PROVISIONED: המכשיר רשום להרשמה דרך הארגון. אפשר להעביר מכשיר PRE_PROVISIONED ליחידה ארגונית אחרת או למחוק אותו. לאחר השלמת הרישום, המכשיר יהיה ACTIVE.
  • DEPROVISIONED: המכשיר כבר לא עומד בדרישות לרישום לדומיין. ההזמנה בוטלה. הגדרות המכשיר נשמרו במטמון. אם המכשיר יופעל שוב, הגדרות המערכת העדכניות יחולו על המכשיר החדש שהופעל.
  • DISABLED: המכשיר הושבת על ידי האדמין ולא ניתן להשתמש בו.
  • INACTIVE: המכשיר לא רשום לדומיין.
  • RETURN_ARRIVED: הבקשה להחלפת המכשיר הזה הגיעה.
  • RETURN_REQUESTED: הוגשה בקשה להחליף את המכשיר הזה.
  • SHIPPED: המכשיר נשלח מהמלאי ב-Google. (הוצאה משימוש)
  • UNKNOWN: לא ניתן לקבוע את סטטוס המכשיר.
lastSync

string

התאריך והשעה שבהם המכשיר סונכרן לאחרונה עם הגדרות המדיניות שבמסוף הניהול. הפורמט של תאריך ושעה לפי ISO 8601. השעה היא התאריך המלא לצד שעות, דקות ושניות בטופס YYYY-MM-DDThh:mm:ssTZD. לדוגמה, 2010-04-05T17:30:04+01:00.
supportEndDate

string

התאריך הסופי שבו תהיה תמיכה במכשיר. האפשרות הזו רלוונטית רק למכשירים שנרכשו ישירות מ-Google. הפורמט של תאריך ושעה לפי ISO 8601. השעה היא התאריך המלא לצד שעות, דקות ושניות בטופס YYYY-MM-DDThh:mm:ssTZD. לדוגמה, 2010-04-05T17:30:04+01:00.
annotatedUser

string

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

string

הכתובת או המיקום של המכשיר, כפי שצוינו על ידי מנהל המערכת. האורך המקסימלי הוא 200 תווים. מותר להזין ערכים ריקים.
notes

string

הערות לגבי המכשיר הזה נוספו על ידי מנהל המערכת. ניתן לחפש את המאפיין הזה באמצעות הפרמטר query של שיטת list. האורך המקסימלי הוא 500 תווים. מותר להזין ערכים ריקים.
model

string

פרטי הדגם של המכשיר. אם המכשיר לא מכיל את המידע הזה, המאפיין הזה לא ייכלל בתגובה.
meid

string

מזהה ציוד נייד (MEID) או IMEI של כרטיס נייד מסוג 3G במכשיר נייד. בדרך כלל משתמשים ב-MEID/IMEI במהלך הוספת מכשיר לתוכנית שירות לאחר תשלום (post-pay) של ספק אלחוטי. אם המכשיר לא מכיל את המידע הזה, המאפיין הזה לא ייכלל בתגובה. מידע נוסף על ייצוא רשימת MEID או IMEI זמין במדריך למפתחים.
orderNumber

string

מספר ההזמנה של המכשיר. רק למכשירים שנרכשו ישירות מ-Google יש מספר הזמנה.
willAutoRenew

boolean

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

string

גרסת מערכת ההפעלה של מכשיר ה-Chrome.
platformVersion

string

גרסת הפלטפורמה של מכשיר ה-Chrome.
firmwareVersion

string

גרסת הקושחה של מכשיר ה-Chrome.
macAddress

string

כתובת ה-MAC האלחוטית של המכשיר. אם המכשיר לא מכיל את המידע הזה, הוא לא ייכלל בתשובה.
bootMode

string

מצב ההפעלה של המכשיר. הערכים האפשריים הם:

  • Verified: במכשיר פועלת גרסה חוקית של מערכת ההפעלה של Chrome.
  • Dev: מתג החומרה של המפתח של המכשיר מופעל. כשהמכשיר מופעל, הוא כולל מעטפת של שורת פקודה. דוגמה להחלפת מפתח זמינה במידע למפתחים של Chromebook.
lastEnrollmentTime

string

התאריך והשעה שבהם המכשיר נרשם לאחרונה. הפורמט של תאריך ושעה לפי ISO 8601. השעה היא התאריך המלא לצד שעות, דקות ושניות בטופס YYYY-MM-DDThh:mm:ssTZD. לדוגמה, 2010-04-05T17:30:04+01:00. מידע נוסף על הרשמה אוטומטית וידנית זמין במרכז העזרה של Chrome.
kind

string

סוג המשאב. הערך של המשאב Chromeosdevices הוא admin#directory#chromeosdevice.
recentUsers[]

object

רשימה של המשתמשים האחרונים במכשיר, בסדר יורד, לפי מועד ההתחברות האחרונה.
recentUsers[].type

string

סוג המשתמש.

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

  • USER_TYPE_MANAGED: המשתמש מנוהל על ידי הדומיין.
  • USER_TYPE_UNMANAGED: המשתמש לא מנוהל על ידי הדומיין.
recentUsers[].email

string

זוהי כתובת האימייל של המשתמש. הערך הזה מוצג רק אם סוג המשתמש הוא USER_TYPE_MANAGED.
activeTimeRanges[]

object

רשימה של טווחי הזמנים הפעילים (לקריאה בלבד).
activeTimeRanges[].activeTime

integer

משך השימוש באלפיות השנייה.
activeTimeRanges[].date

string

תאריך השימוש.
ethernetMacAddress

string

כתובת ה-MAC של המכשיר בממשק של רשת האתרנט.
annotatedAssetId

string

מזהה הנכס, כפי שצוין על ידי האדמין או שצוין במהלך ההרשמה.
etag

string

ה-ETag של המשאב.
diskVolumeReports[]

object

דוחות על נפח אחסון בכונן ומידע אחר על נפחי אחסון טעונים או מחוברים.
diskVolumeReports[].volumeInfo[]

object

נפחי דיסקים
diskVolumeReports[].volumeInfo[].volumeId

string

מזהה כרך
diskVolumeReports[].volumeInfo[].storageTotal

string (int64 format)

נפח האחסון הכולל [בבייטים]
diskVolumeReports[].volumeInfo[].storageFree

string (int64 format)

מקום פנוי בכונן [בבייטים]
systemRamTotal

string (int64 format)

סה"כ RAM במכשיר בבייטים
cpuStatusReports[]

object

דוחות על ניצול המעבד (CPU) והטמפרטורה (לקריאה בלבד)
cpuStatusReports[].reportTime

string

התאריך והשעה שבהם הדוח התקבל.
cpuStatusReports[].cpuUtilizationPercentageInfo[]

integer
cpuStatusReports[].cpuTemperatureInfo[]

object

רשימה של דגימות לטמפרטורות של יחידת עיבוד מרכזית (CPU).
cpuStatusReports[].cpuTemperatureInfo[].temperature

integer

הטמפרטורה במעלות צלזיוס.
cpuStatusReports[].cpuTemperatureInfo[].label

string

תווית של המעבד (CPU)
cpuInfo[]

object

מידע על מפרטי המעבד (CPU) במכשיר.
cpuInfo[].model

string

שם הדגם של המעבד (CPU).
cpuInfo[].architecture

string

הארכיטקטורה של המעבד (CPU).
cpuInfo[].maxClockSpeedKhz

integer

מהירות השעון המקסימלית של המעבד (CPU) ב-kHz.
cpuInfo[].logicalCpus[]

object

מידע על המעבדים הלוגיים
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz

integer

לפי המדיניות, המעבד (CPU) מורשה לפעול בתדירות המקסימלית.
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz

integer

התדר הנוכחי שבו המעבד פועל.
cpuInfo[].logicalCpus[].idleDuration

string (Duration format)

זמן לא פעיל מאז האתחול האחרון.

משך זמן בשניות עם עד תשע ספרות עשרוניות, המסתיים ב-'s'. דוגמה: "3.5s".
cpuInfo[].logicalCpus[].cStates[]

object

מצבי C מציינים את מצב צריכת החשמל של המעבד. למידע נוסף, כדאי לעיין במסמכים שפורסמו על ידי יצרן המעבד (CPU).
cpuInfo[].logicalCpus[].cStates[].displayName

string

שם המדינה.
cpuInfo[].logicalCpus[].cStates[].sessionDuration

string (Duration format)

הזמן שהוקדש למצב מאז ההפעלה מחדש האחרונה.

משך זמן בשניות עם עד תשע ספרות עשרוניות, המסתיים ב-'s'. דוגמה: "3.5s".
deviceFiles[]

object

רשימת קבצים של המכשיר להורדה (לקריאה בלבד)
deviceFiles[].name

string

שם הקובץ
deviceFiles[].type

string

סוג קובץ
deviceFiles[].downloadUrl

string

כתובת URL להורדת קובץ
deviceFiles[].createTime

string

התאריך והשעה שבהם הקובץ נוצר
systemRamFreeReports[]

object

דוחות של כמויות של זיכרון RAM זמין (לקריאה בלבד)
systemRamFreeReports[].reportTime

string

התאריך והשעה שבהם הדוח התקבל.
systemRamFreeReports[].systemRamFreeInfo[]

string (int64 format)
lastKnownNetwork[]

object

מכיל את הרשת הידועה האחרונה (לקריאה בלבד)
lastKnownNetwork[].ipAddress

string

כתובת ה-IP.
lastKnownNetwork[].wanIpAddress

string

כתובת ה-IP של רשת ה-WAN.
autoUpdateExpiration

string (int64 format)

(קריאה בלבד) חותמת הזמן שאחריה המכשיר יפסיק לקבל עדכונים או תמיכה של Chrome
ethernetMacAddress0

string

כתובת MAC (לקריאה בלבד) שמשמשת את יציאת האתרנט הפנימי של ה-Chromebook ואת ממשק הרשת הפנימי (אתרנט). הפורמט כולל שתים-עשרה (12) ספרות הקסדצימליות ללא תו מפריד (אותיות רישיות). האפשרות הזו רלוונטית רק למכשירים מסוימים.
dockMacAddress

string

(לקריאה בלבד) כתובת MAC מובנית לתחנת העגינה שאליה המכשיר התחבר. המערכת מגדירה כתובת לבקרת גישה למדיה (כתובת MAC) שהוקצתה לשימוש על ידי אביזר עגינה. היא שמורה במיוחד למדיניות המכשיר להעברת MAC. הפורמט כולל שתים-עשרה (12) ספרות הקסדצימליות ללא תו מפריד (אותיות רישיות). האפשרות הזו רלוונטית רק למכשירים מסוימים.
manufactureDate

string

(לקריאה בלבד) התאריך שבו המכשיר יוצר בפורמט yyyy-mm-dd.
orgUnitPath

string

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

object

Trusted Platform Module (TPM) (לקריאה בלבד)
tpmVersionInfo.family

string

משפחת TPM. אנחנו משתמשים בקידוד בסגנון TPM 2.0, לדוגמה:
TPM 1.2: "1.2" -> 312e3200
TPM 2.0: "2.0" -> 322e3000
tpmVersionInfo.specLevel

string

רמת מפרט TPM. אפשר לעיין במפרט הספרייה עבור TPM 2.0 ובמפרט הראשי של TPM 1.2.
tpmVersionInfo.manufacturer

string

קוד יצרן TPM.
tpmVersionInfo.tpmModel

string

מספר דגם TPM.
tpmVersionInfo.firmwareVersion

string

גרסת הקושחה TPM.
tpmVersionInfo.vendorSpecific

string

מידע ספציפי לספק, כמו מזהה הספק.
screenshotFiles[]

object

רשימה של קובצי צילום מסך להורדה. הסוג הוא תמיד "SCREENSHOT_FILE". (לקריאה בלבד)
screenshotFiles[].name

string

שם הקובץ
screenshotFiles[].type

string

סוג קובץ
screenshotFiles[].downloadUrl

string

כתובת URL להורדת קובץ
screenshotFiles[].createTime

string

התאריך והשעה שבהם הקובץ נוצר
orgUnitId

string

המזהה הייחודי של היחידה הארגונית. orgUnitPath הוא הגרסה הקריאה לאנשים של orgUnitId. orgUnitPath עשוי להשתנות על ידי שינוי השם של יחידה ארגונית בנתיב, אבל לא ניתן לשנות את orgUnitId ביחידה ארגונית אחת. אפשר לעדכן את הנכס הזה באמצעות ה-API. למידע נוסף על יצירת מבנה ארגוני למכשיר שלך, ניתן לעיין במרכז העזרה לניהול.
osUpdateStatus

object (OsUpdateStatus)

הסטטוס של עדכוני מערכת ההפעלה במכשיר.
firstEnrollmentTime

string

התאריך והשעה שבהם המכשיר נרשם בפעם הראשונה.
lastDeprovisionTimestamp

string

(לקריאה בלבד) התאריך והשעה של הביטול האחרון של ניהול ההקצאות במכשיר.
deprovisionReason

enum (DeprovisionReason)

(לקריאה בלבד) הסיבה לביטול של ניהול ההקצאות.
deviceLicenseType

enum (DeviceLicenseType)

פלט בלבד. סוג הרישיון של המכשיר.
backlightInfo[]

object (BacklightInfo)

פלט בלבד. מכילה מידע על התאורה האחורית של המכשיר.

OsUpdateStatus

מכיל מידע בנוגע לסטטוס העדכון הנוכחי של מערכת ההפעלה.

ייצוג JSON 
{
  "state": enum (UpdateState),
  "targetOsVersion": string,
  "targetKioskAppVersion": string,
  "updateTime": string,
  "updateCheckTime": string,
  "rebootTime": string
}
שדות
state

enum (UpdateState)

מצב העדכון של עדכון מערכת ההפעלה.
targetOsVersion

string

גרסת פלטפורמה חדשה של קובץ האימג' של מערכת ההפעלה שאתם מורידים ומחילים. היא מוגדרת רק כאשר סטטוס העדכון הוא UPDATE_STATUS_DOWNLOAD_IN_PROGRESS או UPDATE_STATUS_NEED_REBOOT. לתשומת ליבך, זו יכולה להיות '0.0.0.0' דמה עבור UPDATE_STATUS_NEED_REBOOT בחלק מהמקרים של קצה. לדוגמה, מנוע העדכון מופעל מחדש ללא אתחול.
targetKioskAppVersion

string

נדרשת גרסת פלטפורמה חדשה מאפליקציית "קיוסק" המעודכנת שבהמתנה.
updateTime

string

התאריך והשעה של עדכון מערכת ההפעלה המוצלח האחרון.
updateCheckTime

string

התאריך והשעה של בדיקת העדכונים האחרונה.
rebootTime

string

התאריך והשעה של ההפעלה מחדש האחרונה.

UpdateState

מצב העדכון של עדכון מערכת ההפעלה.

טיפוסים בני מנייה (enums)
UPDATE_STATE_UNSPECIFIED מצב העדכון לא צוין.
UPDATE_STATE_NOT_STARTED יש עדכון בהמתנה, אבל הוא עדיין לא התחיל.
UPDATE_STATE_DOWNLOAD_IN_PROGRESS מתבצעת הורדה של העדכון שבהמתנה.
UPDATE_STATE_NEED_REBOOT המכשיר מוכן להתקנת העדכון, אבל צריך להפעיל אותו מחדש.

DeprovisionReason

הסיבה לביטול ניהול ההקצאות במכשיר ChromeOS.

טיפוסים בני מנייה (enums)
DEPROVISION_REASON_UNSPECIFIED הסיבה לביטול של ניהול ההקצאות לא ידועה.
DEPROVISION_REASON_SAME_MODEL_REPLACEMENT החלפה לאותו דגם. יש לך הרשאת החזרת חומרים (RMA) או שבחרת להחליף מכשיר לא תקין במסגרת אחריות, באותו הדגם של המכשיר.
DEPROVISION_REASON_UPGRADE

המכשיר שודרג.
DEPROVISION_REASON_DOMAIN_MOVE

הדומיין של המכשיר השתנה.
DEPROVISION_REASON_SERVICE_EXPIRATION

פג תוקף השירות למכשיר.
DEPROVISION_REASON_OTHER

ניהול ההקצאות של המכשיר בוטל מסיבה מדור קודם שאינה נתמכת יותר.
DEPROVISION_REASON_DIFFERENT_MODEL_REPLACEMENT החלפה לדגם אחר. בחרת להחליף את המכשיר הזה בדגם מכשיר משודרג או חדש יותר.
DEPROVISION_REASON_RETIRING_DEVICE עוזב מצי. בחרת לתרום, למחוק או להסיר את המכשיר בצורה אחרת, כדי שלא ייעשה בו שימוש.
DEPROVISION_REASON_UPGRADE_TRANSFER העברה לצורך שדרוג של ChromeOS Flex. זהו מכשיר ChromeOS Flex שבחרת להחליף ב-Chromebook תוך שנה.
DEPROVISION_REASON_NOT_REQUIRED לא נדרשה סיבה. לדוגמה, הרישיונות הוחזרו למאגר הרישיונות של הלקוח.
DEPROVISION_REASON_REPAIR_CENTER ניהול ההקצאות של המכשיר בוטל על ידי מרכז שירות התיקונים. ניתן להגדיר זאת רק על ידי מרכז שירות התיקונים במהלך RMA.

DeviceLicenseType

סוג הרישיון של המכשיר הזה.

טיפוסים בני מנייה (enums)
DEVICE_LICENSE_TYPE_UNSPECIFIED סוג הרישיון אינו ידוע.
ENTERPRISE המכשיר מגיע עם אפשרות מובנית קבועה לשדרוג ל-Chrome Enterprise.
ENTERPRISE_UPGRADE למכשיר יש שדרוג שנתי נפרד ל-Chrome Enterprise.
EDUCATION_UPGRADE למכשיר יש אפשרות מובנית קבועה לשדרוג ל-Chrome Education.
EDUCATION המכשיר מגיע עם אפשרות מובנית קבועה לשדרוג ל-Chrome Education.
KIOSK_UPGRADE למכשיר יש שדרוג שנתי לקיוסק.

BacklightInfo

מידע על התאורה האחורית של המכשיר.

ייצוג JSON 
{
  "path": string,
  "maxBrightness": integer,
  "brightness": integer
}
שדות
path

string

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

integer

פלט בלבד. בהירות מקסימלית לתאורה האחורית.
brightness

integer

פלט בלבד. הבהירות הנוכחית של התאורה האחורית, בין 0 ל-maxBright.

שיטות

action
(deprecated)

 במקום זאת, יש להשתמש ב-BatchChangeChromeOsDeviceStatus.

get

 מאחזר מאפיינים של מכשיר ChromeOS.

list

 אחזור של רשימה מעומדת של מכשירי Chrome OS בתוך חשבון.

moveDevicesToOu

 העברה או הוספה של כמה מכשירי Chrome OS ליחידה ארגונית.

patch

 עדכון מאפיינים של מכשיר שניתן לעדכן, כמו annotatedUser, annotatedLocation, notes, orgUnitPath או annotatedAssetId.

update

 עדכון מאפיינים של מכשיר שניתן לעדכן, כמו annotatedUser, annotatedLocation, notes, orgUnitPath או annotatedAssetId.