منبع: ChromeOsDevice
دستگاههای گوگل کروم روی سیستم عامل کروم اجرا میشوند. برای اطلاعات بیشتر در مورد وظایف رایج 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 | شماره سریال دستگاه کروم که هنگام فعال شدن دستگاه وارد شده است. این مقدار همان شماره سریال کنسول مدیریت در تب دستگاههای سیستم عامل کروم است. |
status | وضعیت دستگاه. مقادیر قابل قبول عبارتند از:
|
lastSync | تاریخ و زمانی که دستگاه آخرین بار با تنظیمات خطمشی در کنسول مدیریت همگامسازی شده است. این مقدار در قالب تاریخ و زمان ISO 8601 است. زمان، تاریخ کامل به علاوه ساعت، دقیقه و ثانیه به شکل |
supportEndDate | تاریخ نهایی پشتیبانی دستگاه. این فقط برای دستگاههایی که مستقیماً از گوگل خریداری شدهاند، قابل استفاده است. مقدار در قالب تاریخ و زمان ISO 8601 است. زمان، تاریخ کامل به علاوه ساعت، دقیقه و ثانیه به شکل |
annotatedUser | کاربر دستگاه همانطور که توسط مدیر سیستم ذکر شده است. حداکثر طول ۱۰۰ کاراکتر است. مقادیر خالی مجاز هستند. |
annotatedLocation | آدرس یا موقعیت مکانی دستگاه همانطور که توسط مدیر سیستم ذکر شده است. حداکثر طول |
notes | یادداشتهایی درباره این دستگاه توسط مدیر اضافه شده است. این ویژگی را میتوان با پارامتر |
model | اطلاعات مدل دستگاه. اگر دستگاه این اطلاعات را نداشته باشد، این ویژگی در پاسخ لحاظ نمیشود. |
meid | شناسه تجهیزات تلفن همراه (MEID) یا شناسه بینالمللی تجهیزات تلفن همراه (IMEI) برای کارت تلفن همراه 3G در یک دستگاه تلفن همراه. MEID/IMEI معمولاً هنگام اضافه کردن یک دستگاه به طرح خدمات پس از پرداخت یک اپراتور بیسیم استفاده میشود. اگر دستگاه این اطلاعات را نداشته باشد، این ویژگی در پاسخ گنجانده نمیشود. برای اطلاعات بیشتر در مورد نحوه استخراج لیست MEID/IMEI، به راهنمای توسعهدهندگان مراجعه کنید. |
orderNumber | شماره سفارش دستگاه. فقط دستگاههایی که مستقیماً از گوگل خریداری شدهاند، شماره سفارش دارند. |
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 | آدرس مک دستگاه روی رابط شبکه اترنت. |
annotatedAssetId | شناسه دارایی که توسط مدیر ذکر شده یا هنگام ثبت نام مشخص شده است. |
etag | برچسب منبع (ETag). |
diskVolumeReports[] | گزارشهایی از فضای دیسک و سایر اطلاعات مربوط به درایوهای نصبشده/متصل. |
diskVolumeReports[].volumeInfo[] | حجم دیسک |
diskVolumeReports[].volumeInfo[].volumeId | شناسه جلد |
diskVolumeReports[].volumeInfo[].storageTotal | کل فضای دیسک [به بایت] |
diskVolumeReports[].volumeInfo[].storageFree | فضای خالی دیسک [به بایت] |
systemRamTotal | کل رم دستگاه بر حسب بایت |
cpuStatusReports[] | گزارشهای مربوط به میزان استفاده و دمای پردازنده (فقط خواندنی) |
cpuStatusReports[].reportTime | تاریخ و زمان دریافت گزارش. |
cpuStatusReports[].cpuUtilizationPercentageInfo[] | |
cpuStatusReports[].cpuTemperatureInfo[] | فهرستی از نمونههای دمای پردازنده. |
cpuStatusReports[].cpuTemperatureInfo[].temperature | دما بر حسب درجه سانتیگراد. |
cpuStatusReports[].cpuTemperatureInfo[].label | برچسب پردازنده |
cpuInfo[] | اطلاعات مربوط به مشخصات CPU در دستگاه. |
cpuInfo[].model | نام مدل پردازنده. |
cpuInfo[].architecture | معماری پردازنده مرکزی (CPU). |
cpuInfo[].maxClockSpeedKhz | حداکثر سرعت کلاک پردازنده (CPU) بر حسب کیلوهرتز |
cpuInfo[].logicalCpus[] | اطلاعات مربوط به پردازندههای منطقی |
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 | آدرس آیپی. |
lastKnownNetwork[].wanIpAddress | آدرس IP شبکه WAN. |
autoUpdateExpiration | (فقط خواندنی) مهر زمانی که پس از آن دستگاه دریافت بهروزرسانیها یا پشتیبانی از Chrome را متوقف میکند. لطفاً به جای آن از «autoUpdateThrough» استفاده کنید. |
ethernetMacAddress0 | آدرس مک (فقط خواندنی) که توسط پورت اترنت داخلی کرومبوک و برای رابط شبکه داخلی (اترنت) استفاده میشود. فرمت آن دوازده (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 | فقط خروجی. نوع سیستم عامل کروم دستگاه. |
diskSpaceUsage | فقط خروجی. چقدر فضای دیسک در دسترس دستگاه است و در حال حاضر از آن استفاده میکند. |
osVersionCompliance | فقط خروجی. وضعیت انطباق با خطمشی دستگاه از نسخه سیستم عامل. |
bluetoothAdapterInfo[] | فقط خروجی. اطلاعات مربوط به آداپتورهای بلوتوث دستگاه. |
وضعیت بهروزرسانی
حاوی اطلاعاتی در مورد وضعیت بهروزرسانی فعلی سیستم عامل است.
| نمایش JSON |
|---|
{
"state": enum ( |
| فیلدها | |
|---|---|
state | وضعیت بهروزرسانی یک سیستمعامل. |
targetOsVersion | نسخه جدید پلتفرم از تصویر سیستم عامل در حال دانلود و اعمال است. این گزینه فقط زمانی تنظیم میشود که وضعیت بهروزرسانی UPDATE_STATUS_DOWNLOAD_IN_PROGRESS یا UPDATE_STATUS_NEED_REBOOT باشد. توجه داشته باشید که در برخی موارد خاص، مثلاً راهاندازی مجدد موتور بهروزرسانی بدون راهاندازی مجدد، میتواند برای UPDATE_STATUS_NEED_REBOOT مقدار "0.0.0.0" را به صورت پیشفرض وارد کنید. |
targetKioskAppVersion | نسخه جدید پلتفرم مورد نیاز از برنامه کیوسک که در انتظار بهروزرسانی است. |
updateTime | تاریخ و زمان آخرین بهروزرسانی موفقیتآمیز سیستم عامل. |
updateCheckTime | تاریخ و زمان آخرین بررسی بهروزرسانی. |
rebootTime | تاریخ و زمان آخرین راه اندازی مجدد. |
وضعیت بهروزرسانی
وضعیت بهروزرسانی یک سیستمعامل.
| انومها | |
|---|---|
UPDATE_STATE_UNSPECIFIED | وضعیت بهروزرسانی مشخص نیست. |
UPDATE_STATE_NOT_STARTED | یک بهروزرسانی در انتظار است اما شروع نشده است. |
UPDATE_STATE_DOWNLOAD_IN_PROGRESS | بهروزرسانی مورد انتظار در حال دانلود است. |
UPDATE_STATE_NEED_REBOOT | دستگاه آماده نصب بهروزرسانی است، اما باید مجدداً راهاندازی شود. |
دلیل محرومیت
دلیل قطع ارائه دستگاه ChromeOS.
| انومها | |
|---|---|
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 توسط مرکز خدمات تعمیرات قابل تنظیم است. |
نوع مجوز دستگاه
نوع مجوز این دستگاه.
| انومها | |
|---|---|
DEVICE_LICENSE_TYPE_UNSPECIFIED | نوع مجوز نامشخص است. |
ENTERPRISE | این دستگاه با ارتقاء دائمی Chrome Enterprise همراه است. |
ENTERPRISE_UPGRADE | این دستگاه دارای یک ارتقاء مستقل سالانه Chrome Enterprise است. |
EDUCATION_UPGRADE | این دستگاه دارای یک ارتقاء آموزشی مستقل و دائمی کروم است. |
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 Upgrade (معروف به مجوز دائمی Chrome EDU) است. |
EDUCATION_UPGRADE_FIXED_TERM | نشان میدهد که دستگاه در حال استفاده از یک نسخه مستقل و با مدت زمان ثابت از Chrome Education Upgrade (معروف به Chrome EDU با مدت زمان ثابت) است. |
اطلاعات نور پس زمینه
اطلاعات مربوط به نور پس زمینه دستگاه.
| نمایش JSON |
|---|
{ "path": string, "maxBrightness": integer, "brightness": integer } |
| فیلدها | |
|---|---|
path | فقط خروجی. مسیر به این نور پس زمینه در سیستم. در صورتی که تماس گیرنده نیاز به ارتباط با سایر اطلاعات داشته باشد، مفید است. |
maxBrightness | فقط خروجی. حداکثر روشنایی برای نور پس زمینه. |
brightness | فقط خروجی. روشنایی فعلی نور پس زمینه، بین ۰ و حداکثر روشنایی. |
اطلاعات طرفداران
اطلاعات مربوط به فن دستگاه.
| نمایش JSON |
|---|
{ "speedRpm": integer } |
| فیلدها | |
|---|---|
speedRpm | فقط خروجی. سرعت فن بر حسب RPM. |
ChromeOsType
نوع سیستم عامل کروم دستگاه.
| انومها | |
|---|---|
CHROME_OS_TYPE_UNSPECIFIED | نوع سیستم عامل کروم مشخص نشده است. |
CHROME_OS_FLEX | نوع سیستم عامل کروم: کروم او اس فلکس. |
CHROME_OS | نوع سیستم عامل کروم: سیستم عامل کروم. |
بایتیوزیج
نشاندهندهی ظرفیت داده با مقداری از استفادهی فعلی بر حسب بایت است.
| نمایش JSON |
|---|
{ "capacityBytes": string, "usedBytes": string } |
| فیلدها | |
|---|---|
capacityBytes | فقط خروجی. مقدار ظرفیت کل، بر حسب بایت. |
usedBytes | فقط خروجی. مقدار استفاده فعلی، بر حسب بایت. |
انطباق
وضعیت انطباق با خطمشی دستگاه مربوط به نسخه سیستم عامل.
| انومها | |
|---|---|
COMPLIANCE_UNSPECIFIED | وضعیت انطباق مشخص نشده است. |
COMPLIANT | وضعیت انطباق مطابق است. |
PENDING | وضعیت انطباق در حال بررسی است. |
NOT_COMPLIANT | وضعیت انطباق مطابق با استاندارد نیست. |
اطلاعات آداپتور بلوتوث
اطلاعات مربوط به آداپتور بلوتوث دستگاه.
| نمایش JSON |
|---|
{ "address": string, "numConnectedDevices": integer } |
| فیلدها | |
|---|---|
address | فقط خروجی. آدرس MAC آداپتور. |
numConnectedDevices | فقط خروجی. تعداد دستگاههای متصل به این آداپتور. |
روشها | |
|---|---|
(deprecated) | به جای آن از BatchChangeChromeOsDeviceStatus استفاده کنید. |
| ویژگیهای دستگاه دارای سیستم عامل کروم را بازیابی میکند. |
| فهرست صفحهبندیشدهای از دستگاههای سیستم عامل کروم درون یک حساب را بازیابی میکند. |
| چندین دستگاه سیستم عامل Chrome را به یک واحد سازمانی منتقل یا وارد میکند. |
| ویژگیهای قابل بهروزرسانی یک دستگاه، مانند annotatedUser ، annotatedLocation ، notes ، orgUnitPath یا annotatedAssetId را بهروزرسانی میکند. |
| ویژگیهای قابل بهروزرسانی یک دستگاه، مانند annotatedUser ، annotatedLocation ، notes ، orgUnitPath یا annotatedAssetId را بهروزرسانی میکند. |