chrome.enterprise.deviceAttributes

refresh date: 2026-09-25 robots: noindex

الوصف

استخدِم واجهة برمجة التطبيقات chrome.enterprise.deviceAttributes لقراءة سمات الجهاز. ملاحظة: لا تتوفّر واجهة برمجة التطبيقات هذه إلا للإضافات التي تم تثبيتها تلقائيًا بموجب سياسة المؤسسة.

الأذونات

enterprise.deviceAttributes

مدى التوفّر

الإصدار 46 من Chrome والإصدارات الأحدث نظام التشغيل ChromeOS فقط يتطلب سياسة

الطُرق

getDeviceAnnotatedLocation()

Promise الإصدار 66 من Chrome والإصدارات الأحدث 
chrome.enterprise.deviceAttributes.getDeviceAnnotatedLocation(
  callback?: function,
): Promise<string>

لجلب الموقع الجغرافي الذي أضاف المشرف تعليقات توضيحية إليه إذا لم يكن المستخدم الحالي تابعًا أو لم يضبط المشرف "موقعًا جغرافيًا مشروحًا"، يتم عرض سلسلة فارغة.

المعلمات

  • callback

    function اختياري

    تظهر المَعلمة callback على النحو التالي: 

    (annotatedLocation: string) => void

    • annotatedLocation

      سلسلة

المرتجعات

  • وعد<سلسلة>

    الإصدار 96 من Chrome أو الإصدارات الأحدث

    تعرض هذه الدالة كائن Promise يتم حله باستخدام الموقع الجغرافي المُضاف إليه تعليقات توضيحية للجهاز.

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، وتحتاج المنصات الأخرى إلى استخدام عمليات الاستدعاء.

getDeviceAssetId()

Promise الإصدار 66 من Chrome والإصدارات الأحدث 
chrome.enterprise.deviceAttributes.getDeviceAssetId(
  callback?: function,
): Promise<string>

لجلب رقم تعريف مادة العرض الذي أضاف المشرف تعليقات توضيحية إليه إذا لم يكن المستخدم الحالي تابعًا أو لم يضبط المشرف رقم تعريف مادة العرض، يتم عرض سلسلة فارغة.

المعلمات

  • callback

    function اختياري

    تظهر المَعلمة callback على النحو التالي: 

    (assetId: string) => void

    • assetId

      سلسلة

المرتجعات

  • وعد<سلسلة>

    الإصدار 96 من Chrome أو الإصدارات الأحدث

    تعرض هذه الطريقة كائن Promise الذي يتم حله باستخدام رقم تعريف مادة العرض للجهاز.

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، وتحتاج المنصات الأخرى إلى استخدام عمليات الاستدعاء.

getDeviceHostname()

Promise الإصدار 82 من Chrome والإصدارات الأحدث 
chrome.enterprise.deviceAttributes.getDeviceHostname(
  callback?: function,
): Promise<string>

تسترجع هذه السياسة اسم مضيف الجهاز كما تم ضبطه من خلال سياسة DeviceHostnameTemplate. إذا لم يكن المستخدم الحالي تابعًا للمؤسسة أو لم يتم ضبط اسم مضيف من خلال سياسة المؤسسة، يتم عرض سلسلة فارغة.

المعلمات

  • callback

    function اختياري

    تظهر المَعلمة callback على النحو التالي: 

    (hostname: string) => void

    • اسم المضيف

      سلسلة

المرتجعات

  • وعد<سلسلة>

    الإصدار 96 من Chrome أو الإصدارات الأحدث

    تعرض هذه الدالة Promise الذي يتم حله باستخدام اسم مضيف الجهاز.

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، وتحتاج المنصات الأخرى إلى استخدام عمليات الاستدعاء.

getDeviceSerialNumber()

Promise الإصدار 66 من Chrome والإصدارات الأحدث 
chrome.enterprise.deviceAttributes.getDeviceSerialNumber(
  callback?: function,
): Promise<string>

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

المعلمات

  • callback

    function اختياري

    تظهر المَعلمة callback على النحو التالي: 

    (serialNumber: string) => void

    • serialNumber

      سلسلة

المرتجعات

  • وعد<سلسلة>

    الإصدار 96 من Chrome أو الإصدارات الأحدث

    تعرض هذه الطريقة كائن Promise يتم حله باستخدام الرقم التسلسلي للجهاز.

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، وتحتاج المنصات الأخرى إلى استخدام عمليات الاستدعاء.

getDirectoryDeviceId()

Promise 
chrome.enterprise.deviceAttributes.getDirectoryDeviceId(
  callback?: function,
): Promise<string>

يتم جلب قيمة معرّف الجهاز لواجهة برمجة تطبيقات الدليل، الذي يتم إنشاؤه بواسطة الخادم ويحدّد سجلّ السحابة الإلكترونية للجهاز من أجل طلب البحث في واجهة برمجة تطبيقات دليل السحابة الإلكترونية. إذا لم يكن المستخدم الحالي تابعًا، يتم عرض سلسلة فارغة.

المعلمات

  • callback

    function اختياري

    تظهر المَعلمة callback على النحو التالي: 

    (deviceId: string) => void

    • deviceId

      سلسلة

المرتجعات

  • وعد<سلسلة>

    الإصدار 96 من Chrome أو الإصدارات الأحدث

    تعرض هذه الطريقة Promise الذي يتم حله باستخدام معرّف الجهاز الخاص بواجهة برمجة تطبيقات الدليل.

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، وتحتاج المنصات الأخرى إلى استخدام عمليات الاستدعاء.