chrome.enterprise.deviceAttributes

refresh date: 2026-09-25 robots: noindex

شرح

از chrome.enterprise.deviceAttributes API برای خواندن مشخصه‌های دستگاه استفاده کنید. توجه: این میانای برنامه‌سازی کاربردی فقط برای افزونه‌هایی دردسترس است که با خط‌مشی سازمانی نصب اجباری شده‌اند.

اجازه‌ها

enterprise.deviceAttributes

دردسترس بودن

Chrome نسخه ۴۶ و بالاتر فقط ChromeOS خط‌مشی لازم است

روش‌ها

getDeviceAnnotatedLocation()

Promise Chrome 66+ 
chrome.enterprise.deviceAttributes.getDeviceAnnotatedLocation(
  callback?: function,
): Promise<string>

«مکان» حاشیه‌نویسی‌شده توسط سرپرست را واکشی می‌کند. اگر کاربر فعلی وابسته نباشد یا سرپرست هیچ «مکان حاشیه‌نویسی‌شده‌ای» تنظیم نکرده باشد، رشته خالی برمی‌گرداند.

پارامترها

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    (annotatedLocation: string) => void

    • annotatedLocation

      رشته

بازگشتی‌ها

  • Promise<string>

    Chrome نسخه ۹۶ به بالا

    یک Promise برمی‌گرداند که با «مکان حاشیه‌نویسی‌شده» دستگاه حل می‌شود.

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

getDeviceAssetId()

Promise Chrome 66+ 
chrome.enterprise.deviceAttributes.getDeviceAssetId(
  callback?: function,
): Promise<string>

«شناسه دارایی» حاشیه‌نویسی‌شده توسط سرپرست را واکشی می‌کند. اگر کاربر فعلی وابسته نباشد یا سرپرست «شناسه دارایی» تنظیم نکرده باشد، رشته خالی برمی‌گرداند.

پارامترها

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    (assetId: string) => void

    • assetId

      رشته

بازگشتی‌ها

  • Promise<string>

    Chrome نسخه ۹۶ به بالا

    یک Promise برمی‌گرداند که با شناسه دارایی دستگاه حل می‌شود.

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

getDeviceHostname()

Promise Chrome 82+ 
chrome.enterprise.deviceAttributes.getDeviceHostname(
  callback?: function,
): Promise<string>

نام میزبان دستگاه را همان‌طور که توسط خط‌مشی DeviceHostnameTemplate تنظیم شده است واکشی می‌کند. اگر کاربر فعلی وابسته نباشد یا هیچ نام میزبانی توسط خط‌مشی سازمانی تنظیم نشده باشد، رشته خالی برمی‌گرداند.

پارامترها

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    (hostname: string) => void

    • نام میزبان

      رشته

بازگشتی‌ها

  • Promise<string>

    Chrome نسخه ۹۶ به بالا

    یک Promise برمی‌گرداند که با نام میزبان دستگاه حل می‌شود.

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

getDeviceSerialNumber()

Promise Chrome 66+ 
chrome.enterprise.deviceAttributes.getDeviceSerialNumber(
  callback?: function,
): Promise<string>

شماره سریال دستگاه را واکشی می‌کند. لطفاً توجه داشته باشید که هدف این API مدیریت دستگاه است (مثلاً تولید «درخواست‌های امضای گواهینامه» برای گواهینامه‌های سراسر دستگاه). از این API نباید برای ردیابی دستگاه‌ها بدون رضایت سرپرست دستگاه استفاده شود. اگر کاربر فعلی وابسته نباشد، رشته خالی برمی‌گرداند.

پارامترها

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    (serialNumber: string) => void

    • serialNumber

      رشته

بازگشتی‌ها

  • Promise<string>

    Chrome نسخه ۹۶ به بالا

    یک Promise برمی‌گرداند که با شماره سریال دستگاه حل می‌شود.

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

getDirectoryDeviceId()

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

مقدار شناسه دستگاه میانای برنامه‌سازی کاربردی دایرکتوری را واکشی می‌کند که توسط سرور تولید می‌شود و سابقه ابری دستگاه را برای پُرسمان در میانای برنامه‌سازی کاربردی دایرکتوری ابری شناسایی می‌کند. اگر کاربر فعلی وابسته نباشد، رشته خالی برمی‌گرداند.

پارامترها

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    (deviceId: string) => void

    • deviceId

      رشته

بازگشتی‌ها

  • Promise<string>

    Chrome نسخه ۹۶ به بالا

    یک Promise برمی‌گرداند که با شناسه دستگاه API دایرکتوری حل می‌شود.

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.