المرجع: ChromeOsDevice
تعمل أجهزة Google Chrome على نظام التشغيل Chrome. لمزيد من المعلومات حول المهام الشائعة لواجهة برمجة التطبيقات، يُرجى الاطّلاع على دليل المطوّر.
تمثيل 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 الذي تم إدخاله عند تفعيل الجهاز هذه القيمة هي نفسها الرقم التسلسلي لوحدة تحكُّم المشرف في علامة التبويب الأجهزة التي تعمل بنظام التشغيل Chrome. |
status |
حالة الجهاز. القيم المقبولة هي:
|
lastSync |
تاريخ ووقت آخر مزامنة للجهاز مع إعدادات السياسات في وحدة تحكم المشرف. تكون القيمة بتنسيق التاريخ والوقت وفقًا لمعيار ISO 8601. الوقت هو التاريخ الكامل مضافًا إليه الساعات والدقائق والثواني بصيغة |
supportEndDate |
التاريخ النهائي لدعم الجهاز. ولا ينطبق ذلك إلا على الأجهزة التي تم شراؤها مباشرةً من Google. تكون القيمة بتنسيق التاريخ والوقت وفقًا لمعيار ISO 8601. الوقت هو التاريخ الكامل مضافًا إليه الساعات والدقائق والثواني بصيغة |
annotatedUser |
مستخدم الجهاز وفقًا لما يشير إليه المشرف. الحد الأقصى للطول هو 100 حرف. يُسمح بالقيم الفارغة. |
annotatedLocation |
يشير إلى عنوان الجهاز أو موقعه الجغرافي وفقًا لما يشير إليه المشرف. الحد الأقصى للطول هو |
notes |
أضاف المشرف ملاحظات حول هذا الجهاز. يمكن البحث عن هذه السمة باستخدام المَعلمة |
model |
معلومات طراز الجهاز إذا لم يكن الجهاز يحتوي على هذه المعلومات، لن يتم تضمين هذه السمة في الرد. |
meid |
معرّف الجهاز الجوّال (MEID) أو الهوية الدولية للأجهزة الجوّالة (IMEI) لبطاقة الجوّال من الجيل الثالث في جهاز جوّال. يتم عادةً استخدام MEID/IMEI عند إضافة جهاز إلى خطة خدمة ما بعد الدفع لمشغّل شبكة الجوّال اللاسلكية. إذا لم يكن الجهاز يحتوي على هذه المعلومات، لن يتم تضمين هذه السمة في الرد. لمزيد من المعلومات حول كيفية تصدير قائمة MEID/IMEI، يُرجى الاطّلاع على دليل المطوِّر. |
orderNumber |
رقم طلب الجهاز. يتوفّر رقم طلب للأجهزة التي تم شراؤها مباشرةً من Google فقط. |
willAutoRenew |
تحدِّد هذه السياسة ما إذا كان الجهاز سيجدِّد دعمه تلقائيًا بعد تاريخ انتهاء الدعم. هذه خاصية للقراءة فقط. |
osVersion |
إصدار نظام تشغيل جهاز Chrome |
platformVersion |
إصدار النظام الأساسي لجهاز Chrome |
firmwareVersion |
إصدار البرامج الثابتة في جهاز Chrome |
macAddress |
عنوان MAC اللاسلكي للجهاز. إذا لم يحتوي الجهاز على هذه المعلومات، لن يتم تضمينه في الاستجابة. |
bootMode |
وضع تشغيل الجهاز القيم المحتملة هي:
|
lastEnrollmentTime |
تاريخ ووقت آخر مرة تم فيها تسجيل الجهاز تكون القيمة بتنسيق التاريخ والوقت وفقًا لمعيار ISO 8601. الوقت هو التاريخ الكامل مضافًا إليه الساعات والدقائق والثواني بصيغة |
kind |
نوع المورد. بالنسبة إلى مورد أجهزة Chrome OS، القيمة هي |
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[] |
تقارير عن استخدام وحدة المعالجة المركزية (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[] |
معلومات عن وحدات المعالجة المركزية المنطقية |
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz |
الحد الأقصى للتكرار المسموح به لتشغيل وحدة المعالجة المركزية (CPU)، حسب السياسة. |
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz |
التردد الحالي لتشغيل وحدة المعالجة المركزية (CPU). |
cpuInfo[].logicalCpus[].idleDuration |
مدة عدم النشاط منذ آخر تشغيل. مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام " |
cpuInfo[].logicalCpus[].cStates[] |
تشير حالات C-State إلى حالة استهلاك الطاقة لوحدة المعالجة المركزية. لمزيد من المعلومات، اطلع على الوثائق التي نشرتها الشركة المصنعة لوحدة المعالجة المركزية (CPU). |
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، وواجهة الشبكة الداخلية (ethernet). يكون التنسيق عبارة عن اثني عشر (12) رقمًا سداسيًا عشريًا بدون أي محدد (أحرف كبيرة). يُرجى العلم أنّ هذا الإجراء ينطبق على بعض الأجهزة فقط. |
dockMacAddress |
(للقراءة فقط) عنوان MAC المُدمج لمحطة الإرساء التي اتصل بها الجهاز. تضبط الإعدادات الأصلية عنوان التحكّم في الوصول إلى الوسائط (عنوان MAC) المحدَّد للاستخدام بواسطة قاعدة إرساء. وهو محجوز تحديدًا لسياسة تمرير MAC على الجهاز. يكون التنسيق عبارة عن اثني عشر (12) رقمًا سداسيًا عشريًا بدون أي محدد (أحرف كبيرة). يُرجى العلم أنّ هذا الإجراء ينطبق على بعض الأجهزة فقط. |
manufactureDate |
(للقراءة فقط) تاريخ تصنيع الجهاز بالتنسيق yyyy-mm-dd |
orgUnitPath |
المسار الرئيسي الكامل مع اسم الوحدة التنظيمية المرتبطة بالجهاز. أسماء المسارات غير حساسة لحالة الأحرف. إذا كانت الوحدة التنظيمية الرئيسية هي المؤسسة ذات المستوى الأعلى، سيتم تمثيلها بشرطة مائلة للأمام، |
tpmVersionInfo |
الوحدة النمطية للنظام الأساسي الموثوق به (TPM) (للقراءة فقط) |
tpmVersionInfo.family |
عائلة TPM. نستخدم ترميز النمط TPM 2.0، على سبيل المثال: |
tpmVersionInfo.specLevel |
مستوى مواصفات الوحدة النمطية للنظام الأساسي الموثوق به. اطّلع على مواصفات المكتبة للوحدة النمطية للنظام الأساسي الموثوق به 2.0 والمواصفات الرئيسية للوحدة النمطية للنظام الأساسي الموثوق به 1.2. |
tpmVersionInfo.manufacturer |
رمز الشركة المصنّعة للوحدة النمطية للنظام الأساسي الموثوق به. |
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 |
النتائج فقط. نوع الجهاز الذي يعمل بنظام التشغيل Chrome |
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 والحدّ الأقصى للسطوع |
FanInfo
معلومات حول مروحة الجهاز
تمثيل JSON |
---|
{ "speedRpm": integer } |
الحقول | |
---|---|
speedRpm |
النتائج فقط. سرعة المروحة في الدقيقة. |
ChromeOsType
نوع الجهاز الذي يعمل بنظام التشغيل Chrome
عمليات التعداد | |
---|---|
CHROME_OS_TYPE_UNSPECIFIED |
لم يتم تحديد نوع نظام التشغيل Chrome. |
CHROME_OS_FLEX |
نظام التشغيل Chrome OS Flex |
CHROME_OS |
نوع نظام التشغيل Chrome: ChromeOS |
الطُرق |
|
---|---|
(deprecated) |
استخدِم BatchChangeChromeOsDeviceStatus بدلاً من ذلك. |
|
لاسترداد خصائص جهاز يعمل بنظام التشغيل ChromeOS. |
|
يسترد قائمة مقسّمة للأجهزة التي تعمل بنظام التشغيل Chrome ضمن حساب واحد. |
|
نقل عدة أجهزة تعمل بنظام التشغيل Chrome أو إدراجها في وحدة تنظيمية |
|
يعدِّل سمات جهاز قابلة للتحديث، مثل annotatedUser أو annotatedLocation أو notes أو orgUnitPath أو annotatedAssetId . |
|
يعدِّل سمات جهاز قابلة للتحديث، مثل annotatedUser أو annotatedLocation أو notes أو orgUnitPath أو annotatedAssetId . |