מקור מידע: ChromeOsDevice
מכשירי Google Chrome פועלים על ChromeOS. מידע נוסף על משימות נפוצות ב-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 ( |
שדות | |
---|---|
deviceId |
המזהה הייחודי של מכשיר Chrome. |
serialNumber |
המספר הסידורי של מכשיר Chrome שהוזן כשהמכשיר הופעל. הערך הזה זהה לערך המספר הסידורי במסוף Admin בכרטיסייה מכשירי ChromeOS. |
status |
הסטטוס של המכשיר. ערכים קבילים:
|
lastSync |
התאריך והשעה שבהם המכשיר סונכרן לאחרונה עם הגדרות המדיניות במסוף Admin. הערך הוא בפורמט תאריך ושעה ISO 8601. הזמן הוא התאריך המלא בתוספת שעות, דקות ושניות בפורמט |
supportEndDate |
התאריך האחרון שבו תהיה תמיכה במכשיר. האפשרות הזו רלוונטית רק למכשירים שנרכשו ישירות מ-Google. הערך הוא בפורמט תאריך ושעה ISO 8601. הזמן הוא התאריך המלא בתוספת שעות, דקות ושניות בפורמט |
annotatedUser |
המשתמש במכשיר כפי שצוין על ידי האדמין. האורך המרבי הוא 100 תווים. מותר להשאיר את הערכים ריקים. |
annotatedLocation |
הכתובת או המיקום של המכשיר כפי שצוינו על ידי האדמין. האורך המרבי הוא |
notes |
הערות לגבי המכשיר הזה שנוספו על ידי האדמין. אפשר לחפש את המאפיין הזה באמצעות הפרמטר |
model |
פרטי הדגם של המכשיר. אם המידע הזה לא זמין במכשיר, המאפיין הזה לא נכלל בתגובה. |
meid |
מזהה הציוד הנייד (MEID) או מזהה הציוד הנייד הבינלאומי (IMEI) של כרטיס 3G במכשיר נייד. בדרך כלל משתמשים ב-MEID/IMEI כשמוסיפים מכשיר לתוכנית שירות בתשלום חודשי של ספק סלולר. אם המידע הזה לא זמין במכשיר, המאפיין הזה לא נכלל בתגובה. מידע נוסף על ייצוא רשימת MEID/IMEI מופיע במדריך למפתחים. |
orderNumber |
מספר ההזמנה של המכשיר. רק למכשירים שנרכשו ישירות מ-Google יש מספר הזמנה. |
willAutoRenew |
ההגדרה קובעת אם התמיכה במכשיר תתחדש אוטומטית אחרי תאריך סיום התמיכה. הנכס הזה הוא לקריאה בלבד. |
osVersion |
גרסת מערכת ההפעלה של מכשיר Chrome. |
platformVersion |
גרסת הפלטפורמה של מכשיר Chrome. |
firmwareVersion |
גרסת הקושחה של מכשיר Chrome. |
macAddress |
כתובת ה-MAC של הרשת האלחוטית של המכשיר. אם המידע הזה לא קיים במכשיר, הוא לא ייכלל בתשובה. |
bootMode |
מצב ההפעלה של המכשיר. הערכים האפשריים הם:
|
lastEnrollmentTime |
התאריך והשעה שבהם המכשיר נרשם לאחרונה. הערך הוא בפורמט תאריך ושעה ISO 8601. הזמן הוא התאריך המלא בתוספת שעות, דקות ושניות בפורמט |
kind |
סוג המשאב. עבור המשאב Chromeosdevices, הערך הוא |
recentUsers[] |
רשימה של משתמשי המכשיר האחרונים, בסדר יורד לפי זמן הכניסה האחרון. |
recentUsers[].type |
סוג המשתמש. ערכים קבילים:
|
recentUsers[].email |
כתובת האימייל של המשתמש. המאפיין הזה מופיע רק אם סוג המשתמש הוא |
activeTimeRanges[] |
רשימה של טווחי זמן פעילים (קריאה בלבד). |
activeTimeRanges[].activeTime |
משך השימוש באלפיות השנייה. |
activeTimeRanges[].date |
תאריך השימוש. |
ethernetMacAddress |
כתובת ה-MAC של המכשיר בממשק רשת אתרנט. |
annotatedAssetId |
מזהה הנכס כפי שצוין על ידי אדמין או במהלך ההרשמה. |
etag |
ETag של המשאב. |
diskVolumeReports[] |
דוחות על נפח אחסון בדיסק ומידע נוסף על אמצעי אחסון שמחוברים או מוצמדים. |
diskVolumeReports[].volumeInfo[] |
נפחי דיסק |
diskVolumeReports[].volumeInfo[].volumeId |
מזהה נפח |
diskVolumeReports[].volumeInfo[].storageTotal |
השטח הכולל בדיסק [בבייטים] |
diskVolumeReports[].volumeInfo[].storageFree |
מקום פנוי בכונן [בבייטים] |
systemRamTotal |
הנפח הכולל של ה-RAM במכשיר בבייטים |
cpuStatusReports[] |
דוחות על ניצול המעבד והטמפרטורה (לקריאה בלבד) |
cpuStatusReports[].reportTime |
התאריך והשעה שבהם הדוח התקבל. |
cpuStatusReports[].cpuUtilizationPercentageInfo[] |
|
cpuStatusReports[].cpuTemperatureInfo[] |
רשימה של דגימות טמפרטורה של יחידת העיבוד המרכזית (CPU). |
cpuStatusReports[].cpuTemperatureInfo[].temperature |
הטמפרטורה במעלות צלזיוס. |
cpuStatusReports[].cpuTemperatureInfo[].label |
תווית של יחידת עיבוד מרכזית (CPU) |
cpuInfo[] |
מידע על מפרט המעבד במכשיר. |
cpuInfo[].model |
שם הדגם של המעבד. |
cpuInfo[].architecture |
ארכיטקטורת המעבד. |
cpuInfo[].maxClockSpeedKhz |
מהירות השעון המקסימלית של המעבד בקילוהרץ. |
cpuInfo[].logicalCpus[] |
מידע על מעבדים לוגיים |
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz |
התדירות המקסימלית שבה המעבד יכול לפעול, בהתאם למדיניות. |
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz |
התדירות הנוכחית שבה המעבד פועל. |
cpuInfo[].logicalCpus[].idleDuration |
זמן ההמתנה מאז האתחול האחרון. משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-' |
cpuInfo[].logicalCpus[].cStates[] |
מצבי C מציינים את מצב צריכת החשמל של המעבד. מידע נוסף זמין במסמכי התיעוד שפורסמו על ידי יצרן המעבד. |
cpuInfo[].logicalCpus[].cStates[].displayName |
שם המדינה. |
cpuInfo[].logicalCpus[].cStates[].sessionDuration |
הזמן שחלף מאז ההפעלה מחדש האחרונה של המכשיר. משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-' |
deviceFiles[] |
רשימה של קבצים במכשיר להורדה (קריאה בלבד) |
deviceFiles[].name |
שם הקובץ |
deviceFiles[].type |
סוג הקובץ |
deviceFiles[].downloadUrl |
כתובת URL להורדת קובץ |
deviceFiles[].createTime |
התאריך והשעה שבהם הקובץ נוצר |
systemRamFreeReports[] |
דוחות על כמות זיכרון ה-RAM הזמין (לקריאה בלבד) |
systemRamFreeReports[].reportTime |
התאריך והשעה שבהם הדוח התקבל. |
systemRamFreeReports[].systemRamFreeInfo[] |
|
lastKnownNetwork[] |
מכיל את הרשת הידועה האחרונה (לקריאה בלבד) |
lastKnownNetwork[].ipAddress |
כתובת ה-IP. |
lastKnownNetwork[].wanIpAddress |
כתובת ה-IP ברשת תקשורת מרחבית (WAN). |
autoUpdateExpiration |
(לקריאה בלבד) חותמת הזמן שאחריה המכשיר יפסיק לקבל עדכונים או תמיכה של Chrome. במקומה צריך להשתמש ב-autoUpdateThrough. |
ethernetMacAddress0 |
(לקריאה בלבד) כתובת ה-MAC שמשמשת את יציאת ה-Ethernet הפנימית של ה-Chromebook ואת ממשק הרשת (Ethernet) המובנה. הפורמט הוא 12 ספרות הקסדצימליות ללא תו מפריד (אותיות רישיות). האפשרות הזו רלוונטית רק לחלק מהמכשירים. |
dockMacAddress |
(לקריאה בלבד) כתובת ה-MAC המובנית של תחנת העגינה שהמכשיר מחובר אליה. המדיניות מגדירה את הכתובת לבקרה על הגישה למדיה (כתובת MAC) שהוקצתה לשימוש באביזר עגינה. הוא שמור במיוחד למדיניות מכשירים של MAC pass through. הפורמט הוא 12 ספרות הקסדצימליות ללא תו מפריד (אותיות רישיות). האפשרות הזו רלוונטית רק לחלק מהמכשירים. |
manufactureDate |
(לקריאה בלבד) התאריך שבו המכשיר יוצר בפורמט yyyy-mm-dd. |
orgUnitPath |
הנתיב המלא של ההורה עם השם של היחידה הארגונית שמשויכת למכשיר. שמות הנתיבים הם לא תלויי-רישיות. אם היחידה הארגונית ברמת ההורה היא הארגון ברמה העליונה, היא מיוצגת באמצעות קו נטוי לפנים, |
tpmVersionInfo |
מודול פלטפורמה מהימנה (TPM) (קריאה בלבד) |
tpmVersionInfo.family |
משפחת TPM. אנחנו משתמשים בקידוד בסגנון TPM 2.0, למשל: |
tpmVersionInfo.specLevel |
רמת המפרט של TPM. אפשר לעיין במפרט הספרייה של TPM 2.0 ובמפרט הראשי של TPM 1.2. |
tpmVersionInfo.manufacturer |
קוד היצרן של TPM. |
tpmVersionInfo.tpmModel |
מספר הדגם של TPM. |
tpmVersionInfo.firmwareVersion |
גרסת הקושחה של מודול פלטפורמה מהימנה (TPM). |
tpmVersionInfo.vendorSpecific |
מידע ספציפי לספק, כמו מזהה הספק. |
screenshotFiles[] |
רשימה של קובצי צילומי מסך להורדה. הסוג הוא תמיד SCREENSHOT_FILE. (לקריאה בלבד) |
screenshotFiles[].name |
שם הקובץ |
screenshotFiles[].type |
סוג הקובץ |
screenshotFiles[].downloadUrl |
כתובת URL להורדת קובץ |
screenshotFiles[].createTime |
התאריך והשעה שבהם הקובץ נוצר |
orgUnitId |
המזהה הייחודי של היחידה הארגונית. orgUnitPath היא הגרסה הקריאה לאנשים של orgUnitId. יכול להיות שה-orgUnitPath ישתנה אם משנים את השם של יחידה ארגונית בנתיב, אבל ה-orgUnitId לא משתנה עבור יחידה ארגונית מסוימת. אפשר לעדכן את המאפיין הזה באמצעות ה-API. מידע נוסף על יצירת מבנה ארגוני למכשיר זמין במרכז העזרה לאדמינים. |
osUpdateStatus |
הסטטוס של עדכוני מערכת ההפעלה במכשיר. |
firstEnrollmentTime |
התאריך והשעה שבהם המכשיר נרשם לראשונה. |
lastDeprovisionTimestamp |
(לקריאה בלבד) התאריך והשעה של ביטול ההקצאה האחרון של המכשיר. |
deprovisionReason |
(קריאה בלבד) הסיבה לביטול של ניהול התצורה. |
deviceLicenseType |
פלט בלבד. סוג הרישיון של המכשיר. |
backlightInfo[] |
פלט בלבד. מכיל מידע על התאורה האחורית של המכשיר. |
autoUpdateThrough |
פלט בלבד. חותמת הזמן שאחריה המכשיר יפסיק לקבל עדכונים או תמיכה של Chrome. |
extendedSupportEligible |
פלט בלבד. האם המכשיר דורש הסכמה לקבלת תמיכה מורחבת. |
extendedSupportStart |
פלט בלבד. התאריך של המכשיר שבו מתחילה מדיניות התמיכה המורחבת לעדכונים אוטומטיים. |
extendedSupportEnabled |
פלט בלבד. האם מדיניות התמיכה המורחבת מופעלת במכשיר. |
fanInfo[] |
פלט בלבד. מידע על המאוורר של המכשיר. |
chromeOsType |
פלט בלבד. סוג המכשיר ב-ChromeOS. |
diskSpaceUsage |
פלט בלבד. כמה נפח אחסון פנוי יש במכשיר וכמה נפח אחסון מנוצל כרגע. |
osVersionCompliance |
פלט בלבד. סטטוס התאימות של גרסת מערכת ההפעלה למדיניות המכשיר. |
OsUpdateStatus
כולל מידע על הסטטוס הנוכחי של עדכון מערכת ההפעלה.
ייצוג ב-JSON |
---|
{
"state": enum ( |
שדות | |
---|---|
state |
מצב העדכון של עדכון מערכת ההפעלה. |
targetOsVersion |
מתבצעת הורדה והחלה של גרסה חדשה של פלטפורמת תמונת מערכת ההפעלה. הערך הזה מוגדר רק כשסטטוס העדכון הוא UPDATE_STATUS_DOWNLOAD_IN_PROGRESS או UPDATE_STATUS_NEED_REBOOT. הערה: יכול להיות שזה יהיה ערך פיקטיבי כמו '0.0.0.0' עבור UPDATE_STATUS_NEED_REBOOT במקרים מסוימים, למשל אם מנוע העדכון מופעל מחדש בלי הפעלה מחדש. |
targetKioskAppVersion |
גרסת פלטפורמה חדשה שנדרשת מאפליקציית הקיוסק הממתינה לעדכון. |
updateTime |
התאריך והשעה שבהם הסתיים בהצלחה עדכון מערכת ההפעלה. |
updateCheckTime |
התאריך והשעה של בדיקת העדכון האחרונה. |
rebootTime |
התאריך והשעה של האתחול האחרון. |
UpdateState
מצב העדכון של עדכון מערכת ההפעלה.
טיפוסים בני מנייה (enum) | |
---|---|
UPDATE_STATE_UNSPECIFIED |
מצב העדכון לא צוין. |
UPDATE_STATE_NOT_STARTED |
יש עדכון בהמתנה, אבל הוא עדיין לא התחיל. |
UPDATE_STATE_DOWNLOAD_IN_PROGRESS |
העדכון בהמתנה נמצא בהורדה. |
UPDATE_STATE_NEED_REBOOT |
המכשיר מוכן להתקנת העדכון, אבל צריך להפעיל אותו מחדש. |
DeprovisionReason
הסיבה לביטול ההקצאה של מכשיר ChromeOS.
טיפוסים בני מנייה (enum) | |
---|---|
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
סוג הרישיון של המכשיר.
טיפוסים בני מנייה (enum) | |
---|---|
DEVICE_LICENSE_TYPE_UNSPECIFIED |
סוג הרישיון לא ידוע. |
ENTERPRISE |
המכשיר מגיע עם שדרוג קבוע ל-Chrome Enterprise. |
ENTERPRISE_UPGRADE |
למכשיר יש שדרוג שנתי נפרד ל-Chrome Enterprise. |
EDUCATION_UPGRADE |
למכשיר יש שדרוג קבוע ונפרד ל-Chrome Education. |
EDUCATION |
המכשיר מגיע בחבילה עם שדרוג קבוע ל-Chrome Education. |
KIOSK_UPGRADE |
למכשיר יש שדרוג שנתי של מכשיר קיוסק. |
ENTERPRISE_UPGRADE_PERPETUAL |
מציין שהמכשיר משתמש בשדרוג נפרד וקבוע ל-Chrome Enterprise, ברישיון ל-Chrome Enterprise. |
ENTERPRISE_UPGRADE_FIXED_TERM |
מציין שהמכשיר משתמש בשדרוג נפרד ל-Chrome Enterprise לתקופה קבועה, ברישיון ל-Chrome Enterprise. |
EDUCATION_UPGRADE_PERPETUAL |
מציין שהמכשיר משתמש בשדרוג ל-Chrome Education עצמאי וקבוע(שנקרא גם רישיון קבוע ל-Chrome EDU). |
EDUCATION_UPGRADE_FIXED_TERM |
מציין שהמכשיר משתמש בשדרוג ל-Chrome Education עצמאי לתקופה קבועה(שנקרא גם רישיון ל-Chrome EDU לתקופה קבועה). |
BacklightInfo
מידע על התאורה האחורית של המכשיר.
ייצוג ב-JSON |
---|
{ "path": string, "maxBrightness": integer, "brightness": integer } |
שדות | |
---|---|
path |
פלט בלבד. הנתיב לתאורה האחורית הזו במערכת. שימושי אם המתקשר צריך לבצע קורלציה עם מידע אחר. |
maxBrightness |
פלט בלבד. הבהירות המקסימלית של התאורה האחורית. |
brightness |
פלט בלבד. הבהירות הנוכחית של התאורה האחורית, בין 0 ל-maxBrightness. |
FanInfo
מידע על המאוורר של המכשיר.
ייצוג ב-JSON |
---|
{ "speedRpm": integer } |
שדות | |
---|---|
speedRpm |
פלט בלבד. מהירות המאוורר בסל"ד. |
ChromeOsType
סוג המכשיר ב-ChromeOS.
טיפוסים בני מנייה (enum) | |
---|---|
CHROME_OS_TYPE_UNSPECIFIED |
סוג Chrome OS לא צוין. |
CHROME_OS_FLEX |
Chrome OS Type Chrome OS Flex. |
CHROME_OS |
Chrome OS: מקלידים Chrome OS. |
ByteUsage
מייצג קיבולת נתונים עם כמות מסוימת של שימוש נוכחי בבייטים.
ייצוג ב-JSON |
---|
{ "capacityBytes": string, "usedBytes": string } |
שדות | |
---|---|
capacityBytes |
פלט בלבד. ערך הקיבולת הכולל בבייטים. |
usedBytes |
פלט בלבד. ערך השימוש הנוכחי, בבייטים. |
תאימות
סטטוס התאימות של גרסת מערכת ההפעלה למדיניות המכשיר.
טיפוסים בני מנייה (enum) | |
---|---|
COMPLIANCE_UNSPECIFIED |
לא צוין סטטוס התאימות. |
COMPLIANT |
סטטוס התאימות הוא 'תואם'. |
PENDING |
סטטוס התאימות: בהמתנה. |
NOT_COMPLIANT |
סטטוס התאימות הוא 'לא תואם'. |
Methods |
|
---|---|
(deprecated) |
במקום זאת, צריך להשתמש ב-BatchChangeChromeOsDeviceStatus. |
|
מאחזר את המאפיינים של מכשיר ChromeOS. |
|
מאחזר רשימה עם חלוקה לדפים של מכשירי ChromeOS בחשבון. |
|
העברה או הוספה של כמה מכשירי ChromeOS ליחידה ארגונית. |
|
עדכון של מאפיינים שניתנים לעדכון במכשיר, כמו annotatedUser , annotatedLocation , notes , orgUnitPath או annotatedAssetId . |
|
עדכון של מאפיינים שניתנים לעדכון במכשיר, כמו annotatedUser , annotatedLocation , notes , orgUnitPath או annotatedAssetId . |