chrome.enterprise.deviceAttributes

الوصف

استخدِم واجهة برمجة التطبيقات 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>

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

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

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

getDeviceAssetId()

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

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

المعلمات

  • callback

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

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

    (assetId: string) => void

    • assetId

      سلسلة

المرتجعات

  • Promise<string>

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

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

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

getDeviceHostname()

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

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

المعلمات

  • callback

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

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

    (hostname: string) => void

    • اسم المضيف

      سلسلة

المرتجعات

  • Promise<string>

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

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

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

getDeviceSerialNumber()

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

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

المعلمات

  • callback

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

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

    (serialNumber: string) => void

    • serialNumber

      سلسلة

المرتجعات

  • Promise<string>

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

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

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

getDirectoryDeviceId()

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

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

المعلمات

  • callback

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

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

    (deviceId: string) => void

    • deviceId

      سلسلة

المرتجعات

  • Promise<string>

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

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

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