REST Resource: chromeosdevices

{
  "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 (OsUpdateStatus)
  },
  "firstEnrollmentTime": string,
  "lastDeprovisionTimestamp": string,
  "deprovisionReason": enum (DeprovisionReason),
  "deviceLicenseType": enum (DeviceLicenseType),
  "backlightInfo": [
    {
      object (BacklightInfo)
    }
  ],
  "autoUpdateThrough": string,
  "extendedSupportEligible": boolean,
  "extendedSupportStart": string,
  "extendedSupportEnabled": boolean,
  "fanInfo": [
    {
      object (FanInfo)
    }
  ],
  "chromeOsType": enum (ChromeOsType)
}

string

المعرّف الفريد لجهاز Chrome.

string

الرقم التسلسلي لجهاز Chrome الذي تم إدخاله عند تفعيل الجهاز هذه القيمة هي نفسها الرقم التسلسلي لوحدة تحكُّم المشرف في علامة التبويب الأجهزة التي تعمل بنظام التشغيل Chrome.

string

حالة الجهاز.

القيم المقبولة هي:

• ACTIVE: الجهاز مسجَّل في النطاق.
• DELINQUENT: انتهت صلاحية الترخيص السنوي للنطاق ولم يعد الجهاز يتلقى السياسات والإعدادات. وعند شراء ترخيص جديد، سيعود الجهاز إلى حالة ACTIVE.
• PRE_PROVISIONED: تم تسجيل الجهاز في إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة. يمكن نقل جهاز PRE_PROVISIONED إلى وحدة تنظيمية مختلفة أو حذفه. بعد اكتمال التسجيل، سيصبح جهاز ACTIVE.
• DEPROVISIONED: لم يعد الجهاز مؤهلاً للتسجيل في النطاق. تم إلغاء الطلب. تم تخزين إعدادات الجهاز مؤقتًا على الجهاز. وفي حال تفعيل الجهاز مرة أخرى، يتم تطبيق أحدث إعدادات النظام على هذا الجهاز الذي تم تفعيله حديثًا.
• DISABLED: تم إيقاف الجهاز من قبل المشرف ولا يمكن استخدامه.
• INACTIVE: الجهاز غير مسجَّل في النطاق.
• RETURN_ARRIVED: وصل طلب استبدال هذا الجهاز.
• RETURN_REQUESTED: تم تقديم طلب لاستبدال هذا الجهاز.
• SHIPPED: تم شحن الجهاز من مستودع Google. (متوقّف نهائيًا)
• UNKNOWN: لا يمكن تحديد حالة الجهاز.

string

تاريخ ووقت آخر مزامنة للجهاز مع إعدادات السياسات في وحدة تحكم المشرف. تكون القيمة بتنسيق التاريخ والوقت وفقًا لمعيار ISO 8601. الوقت هو التاريخ الكامل مضافًا إليه الساعات والدقائق والثواني بصيغة YYYY-MM-DDThh:mm:ssTZD. مثلاً: 2010-04-05T17:30:04+01:00

string

التاريخ النهائي لدعم الجهاز. ولا ينطبق ذلك إلا على الأجهزة التي تم شراؤها مباشرةً من Google. تكون القيمة بتنسيق التاريخ والوقت وفقًا لمعيار ISO 8601. الوقت هو التاريخ الكامل مضافًا إليه الساعات والدقائق والثواني بصيغة YYYY-MM-DDThh:mm:ssTZD. مثلاً: 2010-04-05T17:30:04+01:00

string

مستخدم الجهاز وفقًا لما يشير إليه المشرف. الحد الأقصى للطول هو 100 حرف. يُسمح بالقيم الفارغة.

string

يشير إلى عنوان الجهاز أو موقعه الجغرافي وفقًا لما يشير إليه المشرف. الحد الأقصى للطول هو 200 حرف. يُسمح بالقيم الفارغة.

string

أضاف المشرف ملاحظات حول هذا الجهاز. يمكن البحث عن هذه السمة باستخدام المَعلمة query الخاصة بطريقة list. الحد الأقصى للطول هو 500 حرف. يُسمح بالقيم الفارغة.

string

معلومات طراز الجهاز إذا لم يكن الجهاز يحتوي على هذه المعلومات، لن يتم تضمين هذه السمة في الرد.

string

معرّف الجهاز الجوّال (MEID) أو الهوية الدولية للأجهزة الجوّالة (IMEI) لبطاقة الجوّال من الجيل الثالث في جهاز جوّال. يتم عادةً استخدام MEID/IMEI عند إضافة جهاز إلى خطة خدمة ما بعد الدفع لمشغّل شبكة الجوّال اللاسلكية. إذا لم يكن الجهاز يحتوي على هذه المعلومات، لن يتم تضمين هذه السمة في الرد. لمزيد من المعلومات حول كيفية تصدير قائمة MEID/IMEI، يُرجى الاطّلاع على دليل المطوِّر.

string

رقم طلب الجهاز. يتوفّر رقم طلب للأجهزة التي تم شراؤها مباشرةً من Google فقط.

boolean

تحدِّد هذه السياسة ما إذا كان الجهاز سيجدِّد دعمه تلقائيًا بعد تاريخ انتهاء الدعم. هذه خاصية للقراءة فقط.

string

إصدار نظام تشغيل جهاز Chrome

string

إصدار النظام الأساسي لجهاز Chrome

string

إصدار البرامج الثابتة في جهاز Chrome

string

عنوان MAC اللاسلكي للجهاز. إذا لم يحتوي الجهاز على هذه المعلومات، لن يتم تضمينه في الاستجابة.

string

وضع تشغيل الجهاز القيم المحتملة هي:

• Verified: يعمل الجهاز بإصدار صالح من نظام التشغيل Chrome.
• Dev: مفتاح تبديل الأجهزة لمطوّر البرامج على الجهاز مفعَّل. عند بدء التشغيل، يحتوي الجهاز على واجهة أوامر سطر أوامر. للحصول على مثال عن التبديل بين المطوِّرين، يمكنك الاطّلاع على معلومات مطوِّر برامج Chromebook.

string

تاريخ ووقت آخر مرة تم فيها تسجيل الجهاز تكون القيمة بتنسيق التاريخ والوقت وفقًا لمعيار ISO 8601. الوقت هو التاريخ الكامل مضافًا إليه الساعات والدقائق والثواني بصيغة YYYY-MM-DDThh:mm:ssTZD. مثلاً: 2010-04-05T17:30:04+01:00 لمزيد من المعلومات حول التسجيل التلقائي واليدوي، يُرجى الاطّلاع على مركز مساعدة Chrome.

string

نوع المورد. بالنسبة إلى مورد أجهزة Chrome OS، القيمة هي admin#directory#chromeosdevice.

object

قائمة بمستخدمي الأجهزة الجدد، بترتيب تنازلي، حسب وقت آخر تسجيل دخول.

string

تمثّل هذه السمة نوع المستخدم.

القيم المقبولة هي:

• USER_TYPE_MANAGED: تتم إدارة المستخدم من خلال النطاق.
• USER_TYPE_UNMANAGED: المستخدم لا يديره النطاق.

string

عنوان البريد الإلكتروني للمستخدِم. ولا يتوفّر ذلك إلا إذا كان نوع المستخدم هو USER_TYPE_MANAGED.

object

قائمة بالنطاقات الزمنية النشطة (للقراءة فقط)

integer

مدة الاستخدام بالمللي ثانية.

string

تاريخ الاستخدام.

string

عنوان MAC للجهاز على واجهة شبكة إيثرنت.

string

معرّف مادة العرض كما يشير إليه المشرف أو يتم تحديده أثناء التسجيل.

string

علامة ETag للمورد.

object

تقارير عن مساحة القرص ومعلومات أخرى عن وحدات التخزين المثبَّتة/المتصلة

object

وحدات تخزين القرص

string

معرّف المجلد

string (int64 format)

إجمالي مساحة القرص [بالبايت]

string (int64 format)

المساحة الخالية على القرص [بالبايت]

string (int64 format)

إجمالي ذاكرة الوصول العشوائي على الجهاز بالبايت

object

تقارير عن استخدام وحدة المعالجة المركزية (CPU) ودرجة حرارتها (للقراءة فقط)

string

تاريخ ووقت تلقّي التقرير

integer

object

قائمة بعينات درجة حرارة وحدة المعالجة المركزية (CPU).

integer

درجة الحرارة بالدرجة المئوية.

string

تصنيف وحدة المعالجة المركزية (CPU)

object

معلومات حول مواصفات وحدة المعالجة المركزية (CPU) في الجهاز

string

اسم طراز وحدة المعالجة المركزية (CPU).

string

بنية وحدة المعالجة المركزية (CPU).

integer

أقصى سرعة في ساعة وحدة المعالجة المركزية (CPU) بالكيلوهرتز.

object

معلومات عن وحدات المعالجة المركزية المنطقية

integer

الحد الأقصى للتكرار المسموح به لتشغيل وحدة المعالجة المركزية (CPU)، حسب السياسة.

integer

التردد الحالي لتشغيل وحدة المعالجة المركزية (CPU).

string (Duration format)

مدة عدم النشاط منذ آخر تشغيل.

مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام "s" مثال: "3.5s"

object

تشير حالات C-State إلى حالة استهلاك الطاقة لوحدة المعالجة المركزية. لمزيد من المعلومات، اطلع على الوثائق التي نشرتها الشركة المصنعة لوحدة المعالجة المركزية (CPU).

string

اسم الولاية

string (Duration format)

الوقت الذي قضيته في الحالة منذ آخر عملية إعادة تشغيل.

مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام "s" مثال: "3.5s"

object

قائمة بملفات الجهاز المطلوب تنزيلها (للقراءة فقط)

string

اسم الملف

string

نوع الملف

string

عنوان URL لتنزيل الملف

string

تاريخ ووقت إنشاء الملف

object

تقارير عن مقدار ذاكرة الوصول العشوائي المتاحة (للقراءة فقط)

string

تاريخ ووقت تلقّي التقرير

string (int64 format)

object

يحتوي على آخر شبكة معروفة (للقراءة فقط)

string

عنوان IP.

string

عنوان IP لشبكة WAN.

string (int64 format)

(للقراءة فقط) الطابع الزمني الذي سيتوقف بعده الجهاز عن تلقّي تحديثات Chrome أو دعمه يُرجى استخدام الخيار "autoUpdateThrough" بدلاً من ذلك.

string

(للقراءة فقط) عنوان MAC الذي يستخدمه منفذ إيثرنت الداخلي في جهاز Chromebook، وواجهة الشبكة الداخلية (ethernet). يكون التنسيق عبارة عن اثني عشر (12) رقمًا سداسيًا عشريًا بدون أي محدد (أحرف كبيرة). يُرجى العلم أنّ هذا الإجراء ينطبق على بعض الأجهزة فقط.

string

(للقراءة فقط) عنوان MAC المُدمج لمحطة الإرساء التي اتصل بها الجهاز. تضبط الإعدادات الأصلية عنوان التحكّم في الوصول إلى الوسائط (عنوان MAC) المحدَّد للاستخدام بواسطة قاعدة إرساء. وهو محجوز تحديدًا لسياسة تمرير MAC على الجهاز. يكون التنسيق عبارة عن اثني عشر (12) رقمًا سداسيًا عشريًا بدون أي محدد (أحرف كبيرة). يُرجى العلم أنّ هذا الإجراء ينطبق على بعض الأجهزة فقط.

string

(للقراءة فقط) تاريخ تصنيع الجهاز بالتنسيق yyyy-mm-dd

string

المسار الرئيسي الكامل مع اسم الوحدة التنظيمية المرتبطة بالجهاز. أسماء المسارات غير حساسة لحالة الأحرف. إذا كانت الوحدة التنظيمية الرئيسية هي المؤسسة ذات المستوى الأعلى، سيتم تمثيلها بشرطة مائلة للأمام، /. يمكن تعديل هذا الموقع باستخدام واجهة برمجة التطبيقات. للحصول على مزيد من المعلومات عن كيفية إنشاء بنية تنظيمية لجهازك، راجع مركز مساعدة المشرفين.

object

الوحدة النمطية للنظام الأساسي الموثوق به (TPM) (للقراءة فقط)

string

عائلة TPM. نستخدم ترميز النمط TPM 2.0، على سبيل المثال:
الوحدة النمطية للنظام الأساسي الموثوق به 1.2: "1.2" -> 312e3200
TPM 2.0: "2.0" -> 322e3000

string

مستوى مواصفات الوحدة النمطية للنظام الأساسي الموثوق به. اطّلع على مواصفات المكتبة للوحدة النمطية للنظام الأساسي الموثوق به 2.0 والمواصفات الرئيسية للوحدة النمطية للنظام الأساسي الموثوق به 1.2.

string

رمز الشركة المصنّعة للوحدة النمطية للنظام الأساسي الموثوق به.

string

رقم طراز وحدة النظام الأساسي الموثوق TPM.

string

إصدار البرامج الثابتة لوحدات الأنظمة الأساسية الموثوقة (TPM).

string

معلومات خاصة بالمورّد، مثل رقم تعريف المورّد

object

قائمة بملفات لقطات الشاشة المطلوب تنزيلها النوع دائمًا هو "SCREENSHOT_FILE". (للقراءة فقط)

string

اسم الملف

string

نوع الملف

string

عنوان URL لتنزيل الملف

string

تاريخ ووقت إنشاء الملف

string

المعرّف الفريد للوحدة التنظيمية. إنّ orgUnitPath هو النسخة التي يمكن لشخص عادي قراءتها من orgUnitId. على الرغم من أنّ orgUnitPath قد يتغير عن طريق إعادة تسمية وحدة تنظيمية داخل المسار، لا يمكن تغيير orgUnitId لوحدة تنظيمية واحدة. يمكن تعديل هذا الموقع باستخدام واجهة برمجة التطبيقات. للحصول على مزيد من المعلومات عن كيفية إنشاء بنية تنظيمية لجهازك، راجع مركز مساعدة المشرفين.

object (OsUpdateStatus)

تعرض هذه السمة حالة تحديثات نظام التشغيل للجهاز.

string

تاريخ ووقت أول مرة تم فيها تسجيل الجهاز.

string

(للقراءة فقط) تاريخ ووقت آخر عملية إلغاء توفير المتطلبات اللازمة للجهاز.

enum (DeprovisionReason)

(للقراءة فقط) سبب إيقاف توفير المتطلبات اللازمة.

enum (DeviceLicenseType)

النتائج فقط. نوع ترخيص الجهاز

object (BacklightInfo)

النتائج فقط. تحتوي على معلومات عن الإضاءة الخلفية للجهاز.

string

النتائج فقط. الطابع الزمني الذي سيتوقف عنده الجهاز عن تلقّي تحديثات Chrome أو دعمه

boolean

النتائج فقط. ما إذا كان الجهاز يتطلب الموافقة على الدعم الممتد أم لا

string

النتائج فقط. تاريخ تشغيل الجهاز عند بدء سياسة الدعم الإضافي للتحديثات التلقائية.

boolean

النتائج فقط. ما إذا كان سيتم تفعيل سياسة الدعم الممتد على الجهاز.

object (FanInfo)

النتائج فقط. معلومات المروحة للجهاز

enum (ChromeOsType)

النتائج فقط. نوع الجهاز الذي يعمل بنظام التشغيل Chrome

{
  "state": enum (UpdateState),
  "targetOsVersion": string,
  "targetKioskAppVersion": string,
  "updateTime": string,
  "updateCheckTime": string,
  "rebootTime": string
}

enum (UpdateState)

تشير هذه العلامة إلى حالة تحديث نظام التشغيل.

string

إصدار جديد من النظام الأساسي لصورة نظام التشغيل التي يتم تنزيلها وتطبيقها ولا يتم ضبطها إلا عندما تكون حالة التحديث UPDATE_STATUS_DOWNLOAD_IN_PROGRESS أو UPDATE_STATUS_NEED_REBOOT. يُرجى العِلم أنّ هذا قد يكون عبارة عن "0.0.0.0" وهمي. لـ UPDATE_STATUS_NEED_REBOOT لبعض الحالات الهامشية، مثل. يُعاد تشغيل محرك التحديث بدون إعادة تشغيل.

string

إصدار نظام أساسي جديد مطلوب من تطبيق Kiosk المُحدَّث الذي في انتظار المراجعة.

string

تاريخ ووقت آخر تحديث ناجح لنظام التشغيل

string

تاريخ ووقت آخر عملية بحث عن التحديثات

string

تاريخ آخر عملية إعادة تشغيل ووقتها

{
  "path": string,
  "maxBrightness": integer,
  "brightness": integer
}

string

النتائج فقط. المسار إلى هذه الإضاءة الخلفية في النظام. ويكون هذا الخيار مفيدًا إذا احتاج المتصل إلى الارتباط بمعلومات أخرى.

integer

النتائج فقط. أقصى درجة سطوع للإضاءة الخلفية.

integer

النتائج فقط. السطوع الحالي للإضاءة الخلفية، بين 0 والحدّ الأقصى للسطوع

{
  "speedRpm": integer
}

integer

النتائج فقط. سرعة المروحة في الدقيقة.