منبع: ChromeOsDevice
دستگاههای Google Chrome روی سیستمعامل Chrome اجرا میشوند. برای اطلاعات بیشتر در مورد وظایف متداول 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 | شناسه منحصر به فرد دستگاه کروم. |
serialNumber | شماره سریال دستگاه Chrome که هنگام فعال شدن دستگاه وارد شده است. این مقدار با شماره سریال کنسول مدیریت در برگه دستگاههای سیستم عامل Chrome یکسان است. |
status | وضعیت دستگاه. مقادیر قابل قبول عبارتند از:
|
lastSync | تاریخ و ساعت آخرین همگام سازی دستگاه با تنظیمات خط مشی در کنسول مدیریت. مقدار در قالب تاریخ و زمان ISO 8601 است. زمان تاریخ کامل به اضافه ساعت، دقیقه و ثانیه به شکل |
supportEndDate | تاریخ نهایی پشتیبانی از دستگاه این فقط برای دستگاههایی که مستقیماً از Google خریداری شدهاند قابل اجرا است. مقدار در قالب تاریخ و زمان ISO 8601 است. زمان تاریخ کامل به اضافه ساعت، دقیقه و ثانیه به شکل |
annotatedUser | کاربر دستگاه همانطور که توسط مدیر ذکر شده است. حداکثر طول 100 کاراکتر است. مقادیر خالی مجاز هستند. |
annotatedLocation | آدرس یا مکان دستگاه همانطور که توسط سرپرست ذکر شده است. حداکثر طول |
notes | یادداشتهایی درباره این دستگاه توسط سرپرست اضافه شده است. این ویژگی را می توان با پارامتر |
model | اطلاعات مدل دستگاه اگر دستگاه این اطلاعات را نداشته باشد، این ویژگی در پاسخ منظور نمی شود. |
meid | شناسه تجهیزات موبایل (MEID) یا شناسه بین المللی تجهیزات موبایل (IMEI) برای کارت تلفن همراه 3G در یک دستگاه تلفن همراه. MEID/IMEI معمولاً هنگام افزودن دستگاهی به طرح خدمات پس از پرداخت یک شرکت مخابراتی بیسیم استفاده میشود. اگر دستگاه این اطلاعات را نداشته باشد، این ویژگی در پاسخ منظور نمی شود. برای اطلاعات بیشتر در مورد نحوه صدور لیست MEID/IMEI، به راهنمای توسعهدهنده مراجعه کنید. |
orderNumber | شماره سفارش دستگاه فقط دستگاههایی که مستقیماً از Google خریداری میشوند دارای شماره سفارش هستند. |
willAutoRenew | تعیین می کند که آیا دستگاه پس از تاریخ پایان پشتیبانی، به طور خودکار پشتیبانی خود را تمدید می کند. این یک ویژگی فقط خواندنی است. |
osVersion | نسخه سیستم عامل دستگاه کروم. |
platformVersion | نسخه پلتفرم دستگاه Chrome. |
firmwareVersion | نسخه سیستم عامل دستگاه کروم. |
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[] | گزارش استفاده از CPU و دما (فقط خواندنی) |
cpuStatusReports[].reportTime | تاریخ و ساعت دریافت گزارش |
cpuStatusReports[].cpuUtilizationPercentageInfo[] | |
cpuStatusReports[].cpuTemperatureInfo[] | لیستی از نمونه های دمای CPU |
cpuStatusReports[].cpuTemperatureInfo[].temperature | دما بر حسب درجه سانتیگراد. |
cpuStatusReports[].cpuTemperatureInfo[].label | برچسب CPU |
cpuInfo[] | اطلاعات مربوط به مشخصات CPU در دستگاه. |
cpuInfo[].model | نام مدل CPU |
cpuInfo[].architecture | معماری CPU |
cpuInfo[].maxClockSpeedKhz | حداکثر سرعت کلاک CPU بر حسب کیلوهرتز. |
cpuInfo[].logicalCpus[] | اطلاعات برای CPU های منطقی |
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz | حداکثر فرکانسی که CPU مجاز به اجرا در آن است، بر اساس سیاست. |
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz | فرکانس فعلی CPU در حال کار است. |
cpuInfo[].logicalCpus[].idleDuration | زمان بیکار از آخرین بوت. مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' |
cpuInfo[].logicalCpus[].cStates[] | C-State وضعیت مصرف انرژی CPU را نشان می دهد. برای اطلاعات بیشتر به اسناد منتشر شده توسط سازنده CPU نگاه کنید. |
cpuInfo[].logicalCpus[].cStates[].displayName | نام ایالت. |
cpuInfo[].logicalCpus[].cStates[].sessionDuration | زمان صرف شده در ایالت از آخرین راهاندازی مجدد. مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' |
deviceFiles[] | لیستی از فایل های دستگاه برای دانلود (فقط خواندنی) |
deviceFiles[].name | نام فایل |
deviceFiles[].type | نوع فایل |
deviceFiles[].downloadUrl | آدرس دانلود فایل |
deviceFiles[].createTime | تاریخ و زمان ایجاد فایل |
systemRamFreeReports[] | گزارش مقدار حافظه رم موجود (فقط خواندنی) |
systemRamFreeReports[].reportTime | تاریخ و ساعت دریافت گزارش |
systemRamFreeReports[].systemRamFreeInfo[] | |
lastKnownNetwork[] | حاوی آخرین شبکه شناخته شده (فقط خواندنی) |
lastKnownNetwork[].ipAddress | آدرس IP. |
lastKnownNetwork[].wanIpAddress | آدرس IP WAN. |
autoUpdateExpiration | (فقط خواندنی) مهر زمانی که پس از آن دستگاه دریافت بهروزرسانیها یا پشتیبانی Chrome را متوقف میکند. لطفاً به جای آن از «autoUpdateThrough» استفاده کنید. |
ethernetMacAddress0 | آدرس MAC (فقط خواندنی) که توسط درگاه اترنت داخلی Chromebook و برای رابط شبکه داخلی (اترنت) استفاده میشود. قالب دوازده (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 | آدرس دانلود فایل |
screenshotFiles[].createTime | تاریخ و زمان ایجاد فایل |
orgUnitId | شناسه منحصر به فرد واحد سازمانی. orgUnitPath نسخه قابل خواندن orgUnitId توسط انسان است. در حالی که orgUnitPath ممکن است با تغییر نام یک واحد سازمانی در مسیر تغییر کند، orgUnitId برای یک واحد سازمانی غیر قابل تغییر است. این ویژگی را می توان با استفاده از API به روز کرد . برای اطلاعات بیشتر درباره نحوه ایجاد یک ساختار سازمانی برای دستگاه خود، به مرکز راهنمایی مدیریت مراجعه کنید. |
osUpdateStatus | وضعیت به روز رسانی سیستم عامل برای دستگاه. |
firstEnrollmentTime | تاریخ و زمان برای اولین بار ثبت نام دستگاه. |
lastDeprovisionTimestamp | (فقط خواندنی) تاریخ و زمان آخرین تحویل دستگاه. |
deprovisionReason | (فقط خواندنی) دلیل محرومیت. |
deviceLicenseType | فقط خروجی نوع مجوز دستگاه |
backlightInfo[] | فقط خروجی حاوی اطلاعات نور پس زمینه دستگاه است. |
autoUpdateThrough | فقط خروجی مهر زمانی که پس از آن دستگاه دریافت بهروزرسانی یا پشتیبانی Chrome را متوقف میکند. |
extendedSupportEligible | فقط خروجی این که آیا دستگاه به پشتیبانی گسترده نیاز دارد یا نه. |
extendedSupportStart | فقط خروجی تاریخ دستگاه زمانی که خط مشی پشتیبانی تمدید شده برای بهروزرسانیهای خودکار شروع میشود. |
extendedSupportEnabled | فقط خروجی آیا خط مشی پشتیبانی گسترده در دستگاه فعال است یا خیر. |
fanInfo[] | فقط خروجی اطلاعات فن برای دستگاه |
chromeOsType | فقط خروجی نوع سیستم عامل کروم دستگاه. |
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
وضعیت به روز رسانی یک به روز رسانی سیستم عامل.
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 | این دستگاه با ارتقای دائمی آموزش Chrome همراه است. |
KIOSK_UPGRADE | این دستگاه دارای ارتقا سالانه کیوسک است. |
BacklightInfo
اطلاعاتی در مورد نور پس زمینه دستگاه.
نمایندگی JSON |
---|
{ "path": string, "maxBrightness": integer, "brightness": integer } |
فیلدها | |
---|---|
path | فقط خروجی مسیر این نور پس زمینه در سیستم. اگر تماس گیرنده نیاز به ارتباط با اطلاعات دیگر داشته باشد مفید است. |
maxBrightness | فقط خروجی حداکثر روشنایی برای نور پس زمینه |
brightness | فقط خروجی روشنایی فعلی نور پس زمینه، بین 0 و حداکثر روشنایی. |
فن اینفو
اطلاعاتی در مورد فن دستگاه
نمایندگی JSON |
---|
{ "speedRpm": integer } |
فیلدها | |
---|---|
speedRpm | فقط خروجی سرعت فن در RPM |
ChromeOsType
نوع سیستم عامل کروم دستگاه.
Enums | |
---|---|
CHROME_OS_TYPE_UNSPECIFIED | نوع سیستم عامل کروم مشخص نشده است. |
CHROME_OS_FLEX | سیستم عامل Chrome نوع Chrome OS Flex. |
CHROME_OS | Chrome OS تایپ کنید Chrome OS. |
روش ها | |
---|---|
(deprecated) | به جای آن از BatchChangeChromeOsDeviceStatus استفاده کنید. |
| ویژگی های دستگاه سیستم عامل Chrome را بازیابی می کند. |
| فهرست صفحه بندی شده ای از دستگاه های سیستم عامل Chrome را در یک حساب بازیابی می کند. |
| چندین دستگاه سیستم عامل Chrome را به یک واحد سازمانی منتقل یا وارد میکند. |
| ویژگی های قابل به روز رسانی دستگاه مانند annotatedUser ، annotatedLocation ، notes ، orgUnitPath یا annotatedAssetId را به روز می کند. |
| ویژگی های قابل به روز رسانی دستگاه مانند annotatedUser ، annotatedLocation ، notes ، orgUnitPath یا annotatedAssetId را به روز می کند. |