REST Resource: chromeosdevices

{
  "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)
    }
  ],
  "autoUpdateThrough": string,
  "extendedSupportEligible": boolean,
  "extendedSupportStart": string,
  "extendedSupportEnabled": boolean,
  "fanInfo": [
    {
      object (FanInfo)
    }
  ],
  "chromeOsType": enum (ChromeOsType)
}

string

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

string

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

string

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

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

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

boolean

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

string

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

string

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

string

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

string

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

string

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

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

string

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

string

סוג המשאב. במשאב Chromeosdevices, הערך הוא admin#directory#chromeosdevice.

object

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

string

סוג המשתמש.

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

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

string

כתובת האימייל של המשתמש. הנתון הזה מופיע רק אם סוג המשתמש הוא USER_TYPE_MANAGED.

object

רשימה של טווחי זמן פעילים (לקריאה בלבד).

integer

משך השימוש באלפיות השנייה.

string

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

string

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

string

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

string

ה-ETag של המשאב.

object

דוחות לגבי מקום בכונן ומידע אחר על נפחי אחסון נטענים/מחוברים.

object

נפחי דיסקים

string

מזהה כרך

string (int64 format)

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

string (int64 format)

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

string (int64 format)

נפח ה-RAM הכולל במכשיר בבייטים

object

דוחות על ניצול המעבד והטמפרטורה (לקריאה בלבד)

string

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

integer

object

רשימה של דוגמאות לטמפרטורות של המעבד (CPU).

integer

הטמפרטורה במעלות צלזיוס.

string

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

object

מידע בנוגע למפרטים של המעבד (CPU) במכשיר.

string

שם הדגם של המעבד (CPU).

string

את הארכיטקטורה של המעבד (CPU).

integer

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

object

מידע על מעבדים לוגיים

integer

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

integer

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

string (Duration format)

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

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

object

מצבי C מציינים את מצב צריכת החשמל של המעבד (CPU). מידע נוסף זמין במסמכים שפורסמו על ידי יצרן המעבד (CPU).

string

שם המדינה.

string (Duration format)

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

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

object

רשימה של קבצים להורדה במכשיר (לקריאה בלבד)

string

שם הקובץ

string

סוג הקובץ

string

כתובת URL להורדת הקובץ

string

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

object

דוחות על כמויות ה-RAM הזמינות (לקריאה בלבד)

string

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

string (int64 format)

object

מכיל את הרשת הידועה האחרונה (לקריאה בלבד)

string

כתובת ה-IP.

string

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

string (int64 format)

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

string

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

string

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

string

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

string

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

object

מודול פלטפורמה מהימנה (TPM) (לקריאה בלבד)

string

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

string

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

string

קוד היצרן ל-TPM.

string

מספר הדגם של מודול פלטפורמה מהימנה (TPM).

string

גרסת הקושחה של TPM.

string

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

object

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

string

שם הקובץ

string

סוג הקובץ

string

כתובת URL להורדת הקובץ

string

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

string

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

object (OsUpdateStatus)

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

string

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

string

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

enum (DeprovisionReason)

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

enum (DeviceLicenseType)

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

object (BacklightInfo)

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

string

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

boolean

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

string

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

boolean

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

object (FanInfo)

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

enum (ChromeOsType)

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

{
  "state": enum (UpdateState),
  "targetOsVersion": string,
  "targetKioskAppVersion": string,
  "updateTime": string,
  "updateCheckTime": string,
  "rebootTime": string
}

enum (UpdateState)

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

string

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

string

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

string

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

string

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

string

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

{
  "path": string,
  "maxBrightness": integer,
  "brightness": integer
}

string

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

integer

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

integer

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

{
  "speedRpm": integer
}

integer

פלט בלבד. מהירות המאוורר בהכנסה לאלף צפיות (RPM).