משאב: 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 ( |
שדות | |
---|---|
deviceId |
המזהה הייחודי של מכשיר Chrome. |
serialNumber |
המספר הסידורי של מכשיר Chrome שהוזן כשהמכשיר הופעל. הערך הזה זהה למספר הסידורי במסוף Admin בכרטיסייה מכשירי Chrome OS. |
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[] |
רשימה של טמפרטורות לדוגמה של המעבד. |
cpuStatusReports[].cpuTemperatureInfo[].temperature |
הטמפרטורה במעלות צלזיוס. |
cpuStatusReports[].cpuTemperatureInfo[].label |
תווית של מעבד (CPU) |
cpuInfo[] |
מידע על המפרטים של המעבד במכשיר. |
cpuInfo[].model |
שם הדגם של המעבד. |
cpuInfo[].architecture |
ארכיטקטורת המעבד. |
cpuInfo[].maxClockSpeedKhz |
מהירות השעון המקסימלית של המעבד ב-kHz. |
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 דרך מכשיר. הפורמט הוא 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 |
פלט בלבד. סוג Chrome OS של המכשיר. |
diskSpaceUsage |
פלט בלבד. נפח האחסון הפנוי בכונן והנפח שנעשה בו שימוש כרגע. |
OsUpdateStatus
מכיל מידע על הסטטוס הנוכחי של עדכון מערכת ההפעלה.
ייצוג ב-JSON |
---|
{
"state": enum ( |
שדות | |
---|---|
state |
סטטוס העדכון של עדכון מערכת ההפעלה. |
targetOsVersion |
גרסה חדשה של הפלטפורמה של קובץ האימג' של מערכת ההפעלה שהורדתם והחילותם. הוא מוגדר רק כשסטטוס העדכון הוא UPDATE_STATUS_DOWNLOAD_IN_PROGRESS או UPDATE_STATUS_NEED_REBOOT. הערה: יכול להיות שהערך יהיה '0.0.0.0' לדומיין דמוי (dummy) של 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 |
למכשיר יש שדרוג שנתי של Kiosk. |
BacklightInfo
מידע על התאורה האחורית של המכשיר.
ייצוג ב-JSON |
---|
{ "path": string, "maxBrightness": integer, "brightness": integer } |
שדות | |
---|---|
path |
פלט בלבד. הנתיב לתאורה האחורית הזו במערכת. שימושי אם מבצע הקריאה החוזרת צריך לבצע התאמה למידע אחר. |
maxBrightness |
פלט בלבד. הבהירות המקסימלית של התאורה האחורית. |
brightness |
פלט בלבד. הבהירות הנוכחית של התאורה האחורית, בין 0 ל-maxBrightness. |
FanInfo
מידע על המאוורר של המכשיר.
ייצוג ב-JSON |
---|
{ "speedRpm": integer } |
שדות | |
---|---|
speedRpm |
פלט בלבד. מהירות המאוורר ב-RPM. |
ChromeOsType
סוג Chrome OS של המכשיר.
טיפוסים בני מנייה (enum) | |
---|---|
CHROME_OS_TYPE_UNSPECIFIED |
סוג Chrome OS לא צוין. |
CHROME_OS_FLEX |
Chrome OS מקלידים Chrome OS Flex. |
CHROME_OS |
Chrome OS מקלידים Chrome OS. |
ByteUsage
מייצג קיבולת נתונים עם כמות מסוימת של שימוש נוכחי ביחידות בייטים.
ייצוג ב-JSON |
---|
{ "capacityBytes": string, "usedBytes": string } |
שדות | |
---|---|
capacityBytes |
פלט בלבד. ערך הקיבולת הכולל, בבייטים. |
usedBytes |
פלט בלבד. ערך השימוש הנוכחי, בייטים. |
Methods |
|
---|---|
(deprecated) |
במקום זאת, צריך להשתמש ב-BatchChangeChromeOsDeviceStatus. |
|
אחזור המאפיינים של מכשיר Chrome OS. |
|
אחזור רשימה מחולקת לדפים של מכשירי Chrome OS בחשבון. |
|
העברה או הוספה של כמה מכשירי Chrome OS ליחידה ארגונית. |
|
עדכון המאפיינים הניתנים לעדכון של המכשיר, כמו annotatedUser , annotatedLocation , notes , orgUnitPath או annotatedAssetId . |
|
עדכון המאפיינים הניתנים לעדכון של המכשיר, כמו annotatedUser , annotatedLocation , notes , orgUnitPath או annotatedAssetId . |