المورد: 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 |
نوع المورد. بالنسبة إلى مورد أجهزة Chromeos، القيمة هي |
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[] |
معلومات عن مواصفات وحدة المعالجة المركزية في الجهاز |
cpuInfo[].model |
اسم طراز وحدة المعالجة المركزية (CPU). |
cpuInfo[].architecture |
بنية وحدة المعالجة المركزية (CPU). |
cpuInfo[].maxClockSpeedKhz |
الحد الأقصى لسرعة وحدة المعالجة المركزية (CPU) بالكيلوهرتز. |
cpuInfo[].logicalCpus[] |
معلومات عن وحدات المعالجة المركزية المنطقية |
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz |
تشير السياسة إلى الحد الأقصى للتردد الذي يُسمح بتشغيل وحدة المعالجة المركزية به. |
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz |
التردد الحالي الذي تعمل به وحدة المعالجة المركزية (CPU). |
cpuInfo[].logicalCpus[].idleDuration |
مدة عدم نشاط الجهاز منذ آخر تشغيل مدة بالثواني يصل عددها إلى تسعة أرقام كسرية وتنتهي بـ " |
cpuInfo[].logicalCpus[].cStates[] |
تشير حالات C إلى حالة استهلاك الطاقة لوحدة المعالجة المركزية (CPU). لمزيد من المعلومات، اطلع على الوثائق التي ينشرها منشئ وحدة المعالجة المركزية. |
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 أو الدعم |
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 |
مستوى مواصفات وحدة النظام الأساسي الموثوقة (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[] |
النتائج فقط. يحتوي على معلومات حول الإضاءة الخلفية للجهاز. |
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 والحدّ الأقصى للسطوع |
الطُرق |
|
---|---|
(deprecated) |
استخدِم BatchChangeChromeOsDeviceStatus بدلاً من ذلك. |
|
لاسترداد خصائص جهاز يعمل بنظام التشغيل Chrome. |
|
استرداد قائمة مقسّمة على صفحات للأجهزة التي تعمل بنظام التشغيل Chrome ضمن حساب معيّن. |
|
نقل أو إدراج عدة أجهزة تعمل بنظام التشغيل Chrome إلى وحدة تنظيمية |
|
تعديلات على خصائص الجهاز القابلة للتحديث، مثل annotatedUser أو annotatedLocation أو notes أو orgUnitPath أو annotatedAssetId . |
|
تعديلات على خصائص الجهاز القابلة للتحديث، مثل annotatedUser أو annotatedLocation أو notes أو orgUnitPath أو annotatedAssetId . |