المرجع: ChromeOsDevice
تعمل أجهزة Google Chrome بنظام التشغيل ChromeOS. لمزيد من المعلومات عن مهام واجهة برمجة التطبيقات الشائعة، يُرجى الاطّلاع على دليل المطوّر.
تمثيل 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 الذي تم إدخاله عند تفعيل الجهاز. هذه القيمة هي نفسها الرقم التسلسلي في "وحدة تحكُّم المشرف" ضمن علامة التبويب أجهزة ChromeOS. |
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 |
إصدار نظام التشغيل على جهاز 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 |
إجمالي ذاكرة الوصول العشوائي على الجهاز بالبايت |
cpuStatusReports[] |
تقارير عن استخدام وحدة المعالجة المركزية ودرجة حرارتها (للقراءة فقط) |
cpuStatusReports[].reportTime |
تاريخ ووقت استلام التقرير |
cpuStatusReports[].cpuUtilizationPercentageInfo[] |
|
cpuStatusReports[].cpuTemperatureInfo[] |
قائمة بنماذج درجات حرارة وحدة المعالجة المركزية |
cpuStatusReports[].cpuTemperatureInfo[].temperature |
درجة الحرارة بالدرجة المئوية |
cpuStatusReports[].cpuTemperatureInfo[].label |
تصنيف وحدة المعالجة المركزية |
cpuInfo[] |
معلومات حول مواصفات وحدة المعالجة المركزية (CPU) في الجهاز |
cpuInfo[].model |
اسم طراز وحدة المعالجة المركزية (CPU) |
cpuInfo[].architecture |
بنية وحدة المعالجة المركزية (CPU) |
cpuInfo[].maxClockSpeedKhz |
أقصى سرعة في الساعة لوحدة المعالجة المركزية (CPU) بالكيلوهرتز. |
cpuInfo[].logicalCpus[] |
معلومات عن وحدات المعالجة المركزية (CPU) المنطقية |
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[] |
تقارير عن مقدار ذاكرة الوصول العشوائي المتاحة (للقراءة فقط) |
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 |
عنوان URL لتنزيل الملف |
screenshotFiles[].createTime |
تاريخ إنشاء الملف ووقته |
orgUnitId |
المعرّف الفريد للوحدة التنظيمية. orgUnitPath هو النسخة القابلة للقراءة من orgUnitId. على الرغم من أنّه يمكن تغيير orgUnitPath من خلال إعادة تسمية وحدة تنظيمية ضمن المسار، لا يمكن تغيير orgUnitId لوحدة تنظيمية واحدة. يمكن تعديل هذه السمة باستخدام واجهة برمجة التطبيقات. لمزيد من المعلومات حول كيفية إنشاء بنية تنظيمية لجهازك، يُرجى الاطّلاع على مركز مساعدة الإدارة. |
osUpdateStatus |
حالة تحديثات نظام التشغيل للجهاز |
firstEnrollmentTime |
تاريخ ووقت أول مرة تم فيها تسجيل الجهاز |
lastDeprovisionTimestamp |
(للقراءة فقط) تاريخ ووقت آخر عملية إلغاء توفير الجهاز |
deprovisionReason |
(للقراءة فقط) سبب إزالة الترخيص |
deviceLicenseType |
النتائج فقط. نوع ترخيص الجهاز |
backlightInfo[] |
النتائج فقط. يحتوي على معلومات الإضاءة الخلفية للجهاز. |
autoUpdateThrough |
النتائج فقط. الطابع الزمني الذي بعد انقضاءه سيتوقف الجهاز عن تلقّي تحديثات Chrome أو الدعم |
extendedSupportEligible |
النتائج فقط. ما إذا كان الجهاز يتطلّب تفعيل الدعم الممتد أم لا |
extendedSupportStart |
النتائج فقط. تاريخ الجهاز عند بدء سياسة الدعم الموسّع للتحديثات التلقائية |
extendedSupportEnabled |
النتائج فقط. ما إذا كانت سياسة الدعم الموسَّع مفعّلة على الجهاز |
fanInfo[] |
النتائج فقط. معلومات المروحة للجهاز |
chromeOsType |
النتائج فقط. نوع نظام التشغيل ChromeOS للجهاز |
diskSpaceUsage |
النتائج فقط. يشير إلى مساحة القرص المتوفّرة على الجهاز والمساحة التي يستخدمها حاليًا. |
OsUpdateStatus
يحتوي على معلومات عن حالة تحديث نظام التشغيل الحالية.
تمثيل JSON |
---|
{
"state": enum ( |
الحقول | |
---|---|
state |
حالة تحديث نظام التشغيل |
targetOsVersion |
إصدار جديد من النظام الأساسي لصورة نظام التشغيل يتم تنزيله وتطبيقه لا يتم ضبط هذا الإعداد إلا عندما تكون حالة التحديث UPDATE_STATUS_DOWNLOAD_IN_PROGRESS أو UPDATE_STATUS_NEED_REBOOT. يُرجى العِلم أنّه يمكن أن يكون هذا القيمة "0.0.0.0" وهمية لـ UPDATE_STATUS_NEED_REBOOT في بعض الحالات الشاذة، مثل إعادة تشغيل محرّك التحديث بدون إعادة تشغيل الجهاز. |
targetKioskAppVersion |
إصدار النظام الأساسي الجديد المطلوب من تطبيق Kiosk الذي ينتظر المراجعة |
updateTime |
تاريخ ووقت آخر تحديث ناجح لنظام التشغيل |
updateCheckTime |
تاريخ ووقت آخر عملية بحث عن تحديث |
rebootTime |
تاريخ ووقت آخر عملية إعادة تشغيل |
UpdateState
حالة تحديث نظام التشغيل
عمليات التعداد | |
---|---|
UPDATE_STATE_UNSPECIFIED |
لم يتم تحديد حالة التعديل. |
UPDATE_STATE_NOT_STARTED |
هناك تحديث في انتظار التثبيت ولكن لم يبدأ بعد. |
UPDATE_STATE_DOWNLOAD_IN_PROGRESS |
يتم تنزيل التحديث المعلّق. |
UPDATE_STATE_NEED_REBOOT |
الجهاز جاهز لتثبيت التحديث، ولكن يجب إعادة تشغيله. |
DeprovisionReason
سبب إيقاف توفير المتطلبات اللازمة لجهاز 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 |
تم إيقاف توفير المتطلبات اللازمة للجهاز من قِبل مركز إصلاح الأجهزة. لا يمكن ضبط هذا الإعداد إلا من خلال مركز خدمة الإصلاح أثناء طلب الحصول على إذن بإعادة السلع. |
DeviceLicenseType
نوع ترخيص هذا الجهاز
عمليات التعداد | |
---|---|
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 |
النتائج فقط. سرعة المروحة باللفات في الدقيقة |
ChromeOsType
نوع نظام التشغيل ChromeOS للجهاز
عمليات التعداد | |
---|---|
CHROME_OS_TYPE_UNSPECIFIED |
لم يتم تحديد نوع نظام التشغيل Chrome. |
CHROME_OS_FLEX |
نظام التشغيل Chrome OS: اكتب Chrome OS Flex. |
CHROME_OS |
نظام التشغيل Chrome: اكتب ChromeOS. |
ByteUsage
يمثّل سعة بيانات مع مقدار الاستخدام الحالي بالبايت.
تمثيل JSON |
---|
{ "capacityBytes": string, "usedBytes": string } |
الحقول | |
---|---|
capacityBytes |
النتائج فقط. قيمة السعة الإجمالية، بالبايت |
usedBytes |
النتائج فقط. قيمة الاستخدام الحالية، بالبايت |
الطُرق |
|
---|---|
(deprecated) |
استخدِم BatchChangeChromeOsDeviceStatus بدلاً منه. |
|
يسترجع خصائص جهاز Chrome OS. |
|
يستردّ هذه الدالة قائمة مفصّلة بأجهزة Chrome OS ضمن حساب معيّن. |
|
نقل أجهزة ChromeOS متعددة أو إدراجها في وحدة تنظيمية |
|
تعديل خصائص الجهاز القابلة للتعديل، مثل annotatedUser أو annotatedLocation أو notes أو orgUnitPath أو annotatedAssetId |
|
تعديل خصائص الجهاز القابلة للتعديل، مثل annotatedUser أو annotatedLocation أو notes أو orgUnitPath أو annotatedAssetId |