chrome.enterprise.deviceAttributes

refresh date: 2026-09-25 robots: noindex

الوصف

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

الأذونات

enterprise.deviceAttributes

مدى التوفّر

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

الطُرق

getDeviceAnnotatedLocation()

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

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

المعلمات

  • callback

    الدالة اختيارية

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

    (annotatedLocation: string) => void

    • annotatedLocation

      سلسلة

المرتجعات

  • Promise<string>

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

    تعرض هذه الطريقة Promise يتم تنفيذه مع "الموقع الجغرافي مع التعليقات التوضيحية" للجهاز.

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

getDeviceAssetId()

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

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

المعلمات

  • callback

    الدالة اختيارية

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

    (assetId: string) => void

    • assetId

      سلسلة

المرتجعات

  • Promise<string>

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

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

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

getDeviceHostname()

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

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

المعلمات

  • callback

    الدالة اختيارية

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

    (hostname: string) => void

    • اسم المضيف

      سلسلة

المرتجعات

  • Promise<string>

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

    تعرض هذه الطريقة وعدًا يتم تنفيذه باستخدام اسم مضيف الجهاز.

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

getDeviceSerialNumber()

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

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

المعلمات

  • callback

    الدالة اختيارية

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

    (serialNumber: string) => void

    • serialNumber

      سلسلة

المرتجعات

  • Promise<string>

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

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

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

getDirectoryDeviceId()

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

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

المعلمات

  • callback

    الدالة اختيارية

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

    (deviceId: string) => void

    • deviceId

      سلسلة

المرتجعات

  • Promise<string>

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

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

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