REST Resource: chromeosdevices

منبع: ChromeOsDevice

دستگاه‌های Google Chrome روی سیستم‌عامل Chrome اجرا می‌شوند. برای اطلاعات بیشتر در مورد وظایف متداول API، به راهنمای برنامه نویس مراجعه کنید.

نمایندگی JSON
{
  "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)
    }
  ]
}
زمینه های
deviceId

string

شناسه منحصر به فرد دستگاه کروم.

serialNumber

string

شماره سریال دستگاه Chrome که هنگام فعال شدن دستگاه وارد شده است. این مقدار با شماره سریال کنسول مدیریت در برگه دستگاه‌های سیستم عامل Chrome یکسان است.

status

string

وضعیت دستگاه.

مقادیر قابل قبول عبارتند از:

  • ACTIVE : دستگاه در دامنه ثبت شده است.
  • DELINQUENT : مجوز سالانه دامنه منقضی شده است و دستگاه دیگر خط مشی ها و تنظیمات را دریافت نمی کند. هنگامی که مجوز جدیدی خریداری می شود، دستگاه به حالت ACTIVE برمی گردد.
  • PRE_PROVISIONED : دستگاه برای ثبت نام بدون لمس ثبت شده است. یک دستگاه PRE_PROVISIONED را می توان به واحد سازمانی دیگری منتقل کرد یا حذف کرد. پس از تکمیل ثبت نام، دستگاه ACTIVE خواهد بود.
  • DEPROVISIONED : دستگاه دیگر واجد شرایط ثبت نام در دامنه نیست. سفارش لغو شده است. تنظیمات دستگاه در حافظه پنهان دستگاه ذخیره شده است. اگر دستگاه دوباره فعال شود، آخرین تنظیمات سیستم روی این دستگاه تازه فعال شده اعمال می شود.
  • DISABLED : دستگاه توسط سرپرست غیرفعال شده است و قابل استفاده نیست.
  • INACTIVE : دستگاه در دامنه ثبت نشده است.
  • RETURN_ARRIVED : درخواست تعویض این دستگاه رسیده است.
  • RETURN_REQUESTED : درخواستی برای تعویض این دستگاه ارسال شده است.
  • SHIPPED : دستگاه از موجودی Google ارسال شده است. (منسوخ)
  • UNKNOWN : وضعیت دستگاه را نمی توان تعیین کرد.
lastSync

string

تاریخ و ساعت آخرین همگام سازی دستگاه با تنظیمات خط مشی در کنسول مدیریت. مقدار در قالب تاریخ و زمان ISO 8601 است. زمان تاریخ کامل به اضافه ساعت، دقیقه و ثانیه به شکل YYYY-MM-DDThh:mm:ssTZD . به عنوان مثال، 2010-04-05T17:30:04+01:00 .

supportEndDate

string

تاریخ نهایی پشتیبانی از دستگاه این فقط برای دستگاه‌هایی که مستقیماً از Google خریداری شده‌اند قابل اجرا است. مقدار در قالب تاریخ و زمان ISO 8601 است. زمان تاریخ کامل به اضافه ساعت، دقیقه و ثانیه به شکل YYYY-MM-DDThh:mm:ssTZD . به عنوان مثال، 2010-04-05T17:30:04+01:00 .

annotatedUser

string

کاربر دستگاه همانطور که توسط مدیر ذکر شده است. حداکثر طول 100 کاراکتر است. مقادیر خالی مجاز هستند.

annotatedLocation

string

آدرس یا مکان دستگاه همانطور که توسط سرپرست ذکر شده است. حداکثر طول 200 کاراکتر است. مقادیر خالی مجاز هستند.

notes

string

یادداشت‌هایی درباره این دستگاه توسط سرپرست اضافه شده است. این ویژگی را می توان با پارامتر query متد لیست جستجو کرد. حداکثر طول 500 کاراکتر است. مقادیر خالی مجاز هستند.

model

string

اطلاعات مدل دستگاه اگر دستگاه این اطلاعات را نداشته باشد، این ویژگی در پاسخ منظور نمی شود.

meid

string

شناسه تجهیزات موبایل (MEID) یا شناسه بین المللی تجهیزات موبایل (IMEI) برای کارت تلفن همراه 3G در یک دستگاه تلفن همراه. MEID/IMEI معمولاً هنگام افزودن دستگاهی به طرح خدمات پس از پرداخت یک شرکت مخابراتی بی‌سیم استفاده می‌شود. اگر دستگاه این اطلاعات را نداشته باشد، این ویژگی در پاسخ منظور نمی شود. برای اطلاعات بیشتر در مورد نحوه صدور لیست MEID/IMEI، به راهنمای توسعه‌دهنده مراجعه کنید.

orderNumber

string

شماره سفارش دستگاه فقط دستگاه‌هایی که مستقیماً از Google خریداری می‌شوند دارای شماره سفارش هستند.

willAutoRenew

boolean

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

osVersion

string

نسخه سیستم عامل دستگاه کروم.

platformVersion

string

نسخه پلتفرم دستگاه Chrome.

firmwareVersion

string

نسخه سیستم عامل دستگاه کروم.

macAddress

string

آدرس MAC بی سیم دستگاه. اگر دستگاه این اطلاعات را نداشته باشد، در پاسخ گنجانده نشده است.

bootMode

string

حالت بوت برای دستگاه. مقادیر ممکن عبارتند از:

  • Verified : دستگاه دارای نسخه معتبری از سیستم عامل Chrome است.
  • Dev : سوییچ سخت افزاری برنامه نویس دستگاه ها فعال است. هنگام بوت شدن، دستگاه دارای پوسته خط فرمان است. برای مثالی از سوئیچ برنامه‌نویس، اطلاعات برنامه‌نویس Chromebook را ببینید.
lastEnrollmentTime

string

تاریخ و ساعت آخرین ثبت نام دستگاه. مقدار در قالب تاریخ و زمان ISO 8601 است. زمان تاریخ کامل به اضافه ساعت، دقیقه و ثانیه به شکل YYYY-MM-DDThh:mm:ssTZD . به عنوان مثال، 2010-04-05T17:30:04+01:00 . برای اطلاعات بیشتر درباره ثبت نام خودکار و دستی، به مرکز راهنمای Chrome مراجعه کنید.

kind

string

نوع منبع. برای منبع Chromeosdevices، مقدار admin#directory#chromeosdevice است.

recentUsers[]

object

فهرستی از کاربران اخیر دستگاه، به ترتیب نزولی، بر اساس آخرین زمان ورود به سیستم.

recentUsers[].type

string

نوع کاربر.

مقادیر قابل قبول عبارتند از:

  • USER_TYPE_MANAGED : کاربر توسط دامنه مدیریت می شود.
  • USER_TYPE_UNMANAGED : کاربر توسط دامنه مدیریت نمی شود.
recentUsers[].email

string

آدرس ایمیل کاربر. این فقط در صورتی وجود دارد که نوع کاربر USER_TYPE_MANAGED باشد.

activeTimeRanges[]

object

فهرستی از محدوده زمانی فعال (فقط خواندنی).

activeTimeRanges[].activeTime

integer

مدت زمان استفاده بر حسب میلی ثانیه

activeTimeRanges[].date

string

تاریخ استفاده.

ethernetMacAddress

string

آدرس MAC دستگاه در رابط شبکه اترنت.

annotatedAssetId

string

شناسه دارایی همانطور که توسط یک مدیر ذکر شده است یا در هنگام ثبت نام مشخص شده است.

etag

string

ETag منبع

diskVolumeReports[]

object

گزارش فضای دیسک و سایر اطلاعات در مورد ولوم های نصب شده/متصل.

diskVolumeReports[].volumeInfo[]

object

حجم های دیسک

diskVolumeReports[].volumeInfo[].volumeId

string

شناسه حجم

diskVolumeReports[].volumeInfo[].storageTotal

string ( int64 format)

کل فضای دیسک [بر حسب بایت]

diskVolumeReports[].volumeInfo[].storageFree

string ( int64 format)

فضای خالی دیسک [بر حسب بایت]

systemRamTotal

string ( int64 format)

کل RAM دستگاه بر حسب بایت

cpuStatusReports[]

object

گزارش استفاده از CPU و دما (فقط خواندنی)

cpuStatusReports[].reportTime

string

تاریخ و ساعت دریافت گزارش

cpuStatusReports[].cpuUtilizationPercentageInfo[]

integer

cpuStatusReports[].cpuTemperatureInfo[]

object

لیستی از نمونه های دمای CPU

cpuStatusReports[].cpuTemperatureInfo[].temperature

integer

دما بر حسب درجه سانتیگراد.

cpuStatusReports[].cpuTemperatureInfo[].label

string

برچسب CPU

cpuInfo[]

object

اطلاعات مربوط به مشخصات CPU در دستگاه.

cpuInfo[].model

string

نام مدل CPU

cpuInfo[].architecture

string

معماری CPU

cpuInfo[].maxClockSpeedKhz

integer

حداکثر سرعت کلاک CPU بر حسب کیلوهرتز.

cpuInfo[].logicalCpus[]

object

اطلاعات برای CPU های منطقی

cpuInfo[].logicalCpus[].maxScalingFrequencyKhz

integer

حداکثر فرکانسی که CPU مجاز به اجرا در آن است، بر اساس سیاست.

cpuInfo[].logicalCpus[].currentScalingFrequencyKhz

integer

فرکانس فعلی CPU در حال کار است.

cpuInfo[].logicalCpus[].idleDuration

string ( Duration format)

زمان بیکار از آخرین بوت.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

cpuInfo[].logicalCpus[].cStates[]

object

C-State وضعیت مصرف انرژی CPU را نشان می دهد. برای اطلاعات بیشتر به اسناد منتشر شده توسط سازنده CPU نگاه کنید.

cpuInfo[].logicalCpus[].cStates[].displayName

string

نام ایالت.

cpuInfo[].logicalCpus[].cStates[].sessionDuration

string ( Duration format)

زمان صرف شده در ایالت از آخرین راه‌اندازی مجدد.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

deviceFiles[]

object

لیستی از فایل های دستگاه برای دانلود (فقط خواندنی)

deviceFiles[].name

string

نام فایل

deviceFiles[].type

string

نوع فایل

deviceFiles[].downloadUrl

string

آدرس دانلود فایل

deviceFiles[].createTime

string

تاریخ و زمان ایجاد فایل

systemRamFreeReports[]

object

گزارش مقدار حافظه رم موجود (فقط خواندنی)

systemRamFreeReports[].reportTime

string

تاریخ و ساعت دریافت گزارش

systemRamFreeReports[].systemRamFreeInfo[]

string ( int64 format)

lastKnownNetwork[]

object

حاوی آخرین شبکه شناخته شده (فقط خواندنی)

lastKnownNetwork[].ipAddress

string

آدرس IP.

lastKnownNetwork[].wanIpAddress

string

آدرس IP WAN.

autoUpdateExpiration

string ( int64 format)

(فقط خواندنی) مهر زمانی که پس از آن دستگاه دریافت به‌روزرسانی‌ها یا پشتیبانی Chrome را متوقف می‌کند

ethernetMacAddress0

string

آدرس MAC (فقط خواندنی) که توسط درگاه اترنت داخلی Chromebook و برای رابط شبکه داخلی (اترنت) استفاده می‌شود. قالب دوازده (12) رقم هگزادسیمال بدون هیچ گونه جداکننده (حروف بزرگ) است. این فقط برای برخی از دستگاه ها مرتبط است.

dockMacAddress

string

(فقط خواندنی) آدرس MAC داخلی برای ایستگاه اتصالی که دستگاه به آن متصل است. کارخانه آدرس کنترل دسترسی رسانه (آدرس MAC) را که برای استفاده توسط یک داک اختصاص داده شده است، تنظیم می کند. این به طور خاص برای سیاست عبور دستگاه MAC رزرو شده است. قالب دوازده (12) رقم هگزادسیمال بدون هیچ گونه جداکننده (حروف بزرگ) است. این فقط برای برخی از دستگاه ها مرتبط است.

manufactureDate

string

(فقط خواندنی) تاریخی که دستگاه در قالب yyyy-mm-dd ساخته شده است.

orgUnitPath

string

مسیر کامل والدین با نام واحد سازمانی مرتبط با دستگاه. نام مسیرها به حروف بزرگ و کوچک حساس نیستند. اگر واحد سازمانی والد سازمان سطح بالا باشد، به صورت اسلش رو به جلو نشان داده می شود، / . این ویژگی را می توان با استفاده از API به روز کرد. برای اطلاعات بیشتر درباره نحوه ایجاد یک ساختار سازمانی برای دستگاه خود، به مرکز راهنمایی مدیریت مراجعه کنید.

tpmVersionInfo

object

ماژول پلتفرم مورد اعتماد (TPM) (فقط خواندنی)

tpmVersionInfo.family

string

خانواده TPM ما از رمزگذاری سبک TPM 2.0 استفاده می کنیم، به عنوان مثال:
TPM 1.2: "1.2" -> 312e3200
TPM 2.0: "2.0" -> 322e3000

tpmVersionInfo.specLevel

string

سطح مشخصات TPM مشخصات کتابخانه برای TPM 2.0 و مشخصات اصلی برای TPM 1.2 را ببینید.

tpmVersionInfo.manufacturer

string

کد سازنده TPM

tpmVersionInfo.tpmModel

string

شماره مدل TPM

tpmVersionInfo.firmwareVersion

string

نسخه سیستم عامل TPM.

tpmVersionInfo.vendorSpecific

string

اطلاعات خاص فروشنده مانند شناسه فروشنده.

screenshotFiles[]

object

لیستی از فایل های اسکرین شات برای دانلود. نوع همیشه "SCREENSHOT_FILE" است. (فقط خواندنی)

screenshotFiles[].name

string

نام فایل

screenshotFiles[].type

string

نوع فایل

screenshotFiles[].downloadUrl

string

آدرس دانلود فایل

screenshotFiles[].createTime

string

تاریخ و زمان ایجاد فایل

orgUnitId

string

شناسه منحصر به فرد واحد سازمانی. orgUnitPath نسخه قابل خواندن orgUnitId توسط انسان است. در حالی که orgUnitPath ممکن است با تغییر نام یک واحد سازمانی در مسیر تغییر کند، orgUnitId برای یک واحد سازمانی غیر قابل تغییر است. این ویژگی را می توان با استفاده از API به روز کرد. برای اطلاعات بیشتر درباره نحوه ایجاد یک ساختار سازمانی برای دستگاه خود، به مرکز راهنمایی مدیریت مراجعه کنید.

osUpdateStatus

object ( OsUpdateStatus )

وضعیت به روز رسانی سیستم عامل برای دستگاه.

firstEnrollmentTime

string

تاریخ و زمان برای اولین بار ثبت نام دستگاه.

lastDeprovisionTimestamp

string

(فقط خواندنی) تاریخ و زمان آخرین تحویل دستگاه.

deprovisionReason

enum ( DeprovisionReason )

(فقط خواندنی) دلیل محرومیت.

deviceLicenseType

enum ( DeviceLicenseType )

فقط خروجی نوع مجوز دستگاه

backlightInfo[]

object ( BacklightInfo )

فقط خروجی حاوی اطلاعات نور پس زمینه دستگاه است.

OsUpdateStatus

حاوی اطلاعات مربوط به وضعیت فعلی به روز رسانی سیستم عامل است.

نمایندگی JSON
{
  "state": enum (UpdateState),
  "targetOsVersion": string,
  "targetKioskAppVersion": string,
  "updateTime": string,
  "updateCheckTime": string,
  "rebootTime": string
}
زمینه های
state

enum ( UpdateState )

وضعیت به روز رسانی یک به روز رسانی سیستم عامل.

targetOsVersion

string

نسخه پلتفرم جدید تصویر سیستم عامل در حال دانلود و اعمال است. فقط زمانی تنظیم می‌شود که وضعیت به‌روزرسانی UPDATE_STATUS_DOWNLOAD_IN_PROGRESS یا UPDATE_STATUS_NEED_REBOOT باشد. توجه داشته باشید که این می تواند یک "0.0.0.0" ساختگی برای UPDATE_STATUS_NEED_REBOOT برای برخی از موارد لبه باشد، به عنوان مثال موتور به روز رسانی بدون راه اندازی مجدد راه اندازی مجدد می شود.

targetKioskAppVersion

string

نسخه جدید پلت فرم مورد نیاز از برنامه کیوسک به روز شده در حال انتظار.

updateTime

string

تاریخ و زمان آخرین به روز رسانی موفق سیستم عامل.

updateCheckTime

string

تاریخ و زمان آخرین بررسی به‌روزرسانی.

rebootTime

string

تاریخ و زمان آخرین راه اندازی مجدد

UpdateState

وضعیت به روز رسانی یک به روز رسانی سیستم عامل.

Enums
UPDATE_STATE_UNSPECIFIED وضعیت به روز رسانی نامشخص است.
UPDATE_STATE_NOT_STARTED یک به روز رسانی در انتظار وجود دارد اما شروع نشده است.
UPDATE_STATE_DOWNLOAD_IN_PROGRESS به‌روزرسانی معلق در حال دانلود است.
UPDATE_STATE_NEED_REBOOT دستگاه آماده نصب به‌روزرسانی است، اما باید راه‌اندازی مجدد شود.

DeprovisionReason

دلیل عدم ارائه یک دستگاه ChromeOS.

Enums
DEPROVISION_REASON_UNSPECIFIED دلیل محرومیت نامشخص است.
DEPROVISION_REASON_SAME_MODEL_REPLACEMENT تعویض همون مدل شما دارای مجوز بازگشت مواد (RMA) هستید یا در حال تعویض دستگاه خراب تحت گارانتی با همان مدل دستگاه هستید.
DEPROVISION_REASON_UPGRADE

دستگاه ارتقا یافت.

DEPROVISION_REASON_DOMAIN_MOVE

دامنه دستگاه تغییر کرد.

DEPROVISION_REASON_SERVICE_EXPIRATION

سرویس برای دستگاه منقضی شده است.

DEPROVISION_REASON_OTHER

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

DEPROVISION_REASON_DIFFERENT_MODEL_REPLACEMENT جایگزینی مدل های مختلف شما در حال جایگزینی این دستگاه با یک مدل دستگاه ارتقا یافته یا جدیدتر هستید.
DEPROVISION_REASON_RETIRING_DEVICE بازنشستگی از ناوگان شما در حال اهدا، دور انداختن یا حذف دستگاه از استفاده هستید.
DEPROVISION_REASON_UPGRADE_TRANSFER انتقال ارتقاء ChromeOS Flex. این یک دستگاه ChromeOS Flex است که ظرف یک سال آن را با Chromebook جایگزین می‌کنید.
DEPROVISION_REASON_NOT_REQUIRED دلیلی لازم نبود به عنوان مثال، مجوزها به استخر مجوز مشتری بازگردانده شد.
DEPROVISION_REASON_REPAIR_CENTER دستگاه توسط مرکز خدمات تعمیرات خارج شده است. فقط می تواند توسط مرکز خدمات تعمیر در طول RMA تنظیم شود.

DeviceLicenseType

نوع مجوز این دستگاه

Enums
DEVICE_LICENSE_TYPE_UNSPECIFIED نوع مجوز مشخص نیست.
ENTERPRISE دستگاه همراه با ارتقای دائمی Chrome Enterprise است.
ENTERPRISE_UPGRADE این دستگاه دارای ارتقاء سالانه Chrome Enterprise مستقل است.
EDUCATION_UPGRADE این دستگاه دارای ارتقای آموزش Chrome مستقل دائمی است.
EDUCATION این دستگاه با ارتقای دائمی آموزش Chrome همراه است.
KIOSK_UPGRADE این دستگاه دارای ارتقا سالانه کیوسک است.

BacklightInfo

اطلاعاتی در مورد نور پس زمینه دستگاه.

نمایندگی JSON
{
  "path": string,
  "maxBrightness": integer,
  "brightness": integer
}
زمینه های
path

string

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

maxBrightness

integer

فقط خروجی حداکثر روشنایی برای نور پس زمینه

brightness

integer

فقط خروجی روشنایی فعلی نور پس زمینه، بین 0 و حداکثر روشنایی.

مواد و روش ها

action
(deprecated)

 به جای آن از BatchChangeChromeOsDeviceStatus استفاده کنید.

get

 ویژگی های دستگاه سیستم عامل Chrome را بازیابی می کند.

list

 فهرست صفحه بندی شده ای از دستگاه های سیستم عامل Chrome را در یک حساب بازیابی می کند.

moveDevicesToOu

 چندین دستگاه سیستم عامل Chrome را به یک واحد سازمانی منتقل یا درج می کند.

patch

 ویژگی‌های قابل به‌روزرسانی دستگاه، مانند annotatedUser ، annotatedLocation ، notes ، orgUnitPath یا annotatedAssetId را به‌روزرسانی می‌کند.

update

 ویژگی‌های قابل به‌روزرسانی دستگاه، مانند annotatedUser ، annotatedLocation ، notes ، orgUnitPath یا annotatedAssetId را به‌روزرسانی می‌کند.
،

منبع: ChromeOsDevice

دستگاه‌های Google Chrome روی سیستم‌عامل Chrome اجرا می‌شوند. برای اطلاعات بیشتر در مورد وظایف متداول API، به راهنمای برنامه نویس مراجعه کنید.

نمایندگی JSON
{
  "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)
    }
  ]
}
زمینه های
deviceId

string

شناسه منحصر به فرد دستگاه کروم.

serialNumber

string

شماره سریال دستگاه Chrome که هنگام فعال شدن دستگاه وارد شده است. این مقدار با شماره سریال کنسول مدیریت در برگه دستگاه‌های سیستم عامل Chrome یکسان است.

status

string

وضعیت دستگاه.

مقادیر قابل قبول عبارتند از:

  • ACTIVE : دستگاه در دامنه ثبت شده است.
  • DELINQUENT : مجوز سالانه دامنه منقضی شده است و دستگاه دیگر خط مشی ها و تنظیمات را دریافت نمی کند. هنگامی که مجوز جدیدی خریداری می شود، دستگاه به حالت ACTIVE برمی گردد.
  • PRE_PROVISIONED : دستگاه برای ثبت نام بدون لمس ثبت شده است. یک دستگاه PRE_PROVISIONED را می توان به واحد سازمانی دیگری منتقل کرد یا حذف کرد. پس از تکمیل ثبت نام، دستگاه ACTIVE خواهد بود.
  • DEPROVISIONED : دستگاه دیگر واجد شرایط ثبت نام در دامنه نیست. سفارش لغو شده است. تنظیمات دستگاه در حافظه پنهان دستگاه ذخیره شده است. اگر دستگاه دوباره فعال شود، آخرین تنظیمات سیستم روی این دستگاه تازه فعال شده اعمال می شود.
  • DISABLED : دستگاه توسط سرپرست غیرفعال شده است و قابل استفاده نیست.
  • INACTIVE : دستگاه در دامنه ثبت نشده است.
  • RETURN_ARRIVED : درخواست تعویض این دستگاه رسیده است.
  • RETURN_REQUESTED : درخواستی برای تعویض این دستگاه ارسال شده است.
  • SHIPPED : دستگاه از موجودی Google ارسال شده است. (منسوخ)
  • UNKNOWN : وضعیت دستگاه را نمی توان تعیین کرد.
lastSync

string

تاریخ و ساعت آخرین همگام سازی دستگاه با تنظیمات خط مشی در کنسول مدیریت. مقدار در قالب تاریخ و زمان ISO 8601 است. زمان تاریخ کامل به اضافه ساعت، دقیقه و ثانیه به شکل YYYY-MM-DDThh:mm:ssTZD . به عنوان مثال، 2010-04-05T17:30:04+01:00 .

supportEndDate

string

تاریخ نهایی پشتیبانی از دستگاه این فقط برای دستگاه‌هایی که مستقیماً از Google خریداری شده‌اند قابل اجرا است. مقدار در قالب تاریخ و زمان ISO 8601 است. زمان تاریخ کامل به اضافه ساعت، دقیقه و ثانیه به شکل YYYY-MM-DDThh:mm:ssTZD . به عنوان مثال، 2010-04-05T17:30:04+01:00 .

annotatedUser

string

کاربر دستگاه همانطور که توسط مدیر ذکر شده است. حداکثر طول 100 کاراکتر است. مقادیر خالی مجاز هستند.

annotatedLocation

string

آدرس یا مکان دستگاه همانطور که توسط سرپرست ذکر شده است. حداکثر طول 200 کاراکتر است. مقادیر خالی مجاز هستند.

notes

string

یادداشت‌هایی درباره این دستگاه توسط سرپرست اضافه شده است. این ویژگی را می توان با پارامتر query متد لیست جستجو کرد. حداکثر طول 500 کاراکتر است. مقادیر خالی مجاز هستند.

model

string

اطلاعات مدل دستگاه اگر دستگاه این اطلاعات را نداشته باشد، این ویژگی در پاسخ منظور نمی شود.

meid

string

شناسه تجهیزات موبایل (MEID) یا شناسه بین المللی تجهیزات موبایل (IMEI) برای کارت تلفن همراه 3G در یک دستگاه تلفن همراه. MEID/IMEI معمولاً هنگام افزودن دستگاهی به طرح خدمات پس از پرداخت یک شرکت مخابراتی بی‌سیم استفاده می‌شود. اگر دستگاه این اطلاعات را نداشته باشد، این ویژگی در پاسخ منظور نمی شود. برای اطلاعات بیشتر در مورد نحوه صدور لیست MEID/IMEI، به راهنمای توسعه‌دهنده مراجعه کنید.

orderNumber

string

شماره سفارش دستگاه فقط دستگاه‌هایی که مستقیماً از Google خریداری می‌شوند دارای شماره سفارش هستند.

willAutoRenew

boolean

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

osVersion

string

نسخه سیستم عامل دستگاه کروم.

platformVersion

string

نسخه پلتفرم دستگاه Chrome.

firmwareVersion

string

نسخه سیستم عامل دستگاه کروم.

macAddress

string

آدرس MAC بی سیم دستگاه. اگر دستگاه این اطلاعات را نداشته باشد، در پاسخ گنجانده نشده است.

bootMode

string

حالت بوت برای دستگاه. مقادیر ممکن عبارتند از:

  • Verified : دستگاه دارای نسخه معتبری از سیستم عامل Chrome است.
  • Dev : سوییچ سخت افزاری برنامه نویس دستگاه ها فعال است. هنگام بوت شدن، دستگاه دارای پوسته خط فرمان است. برای مثالی از سوئیچ برنامه‌نویس، اطلاعات برنامه‌نویس Chromebook را ببینید.
lastEnrollmentTime

string

تاریخ و ساعت آخرین ثبت نام دستگاه. مقدار در قالب تاریخ و زمان ISO 8601 است. زمان تاریخ کامل به اضافه ساعت، دقیقه و ثانیه به شکل YYYY-MM-DDThh:mm:ssTZD . به عنوان مثال، 2010-04-05T17:30:04+01:00 . برای اطلاعات بیشتر درباره ثبت نام خودکار و دستی، به مرکز راهنمای Chrome مراجعه کنید.

kind

string

نوع منبع. برای منبع Chromeosdevices، مقدار admin#directory#chromeosdevice است.

recentUsers[]

object

فهرستی از کاربران اخیر دستگاه، به ترتیب نزولی، بر اساس آخرین زمان ورود به سیستم.

recentUsers[].type

string

نوع کاربر.

مقادیر قابل قبول عبارتند از:

  • USER_TYPE_MANAGED : کاربر توسط دامنه مدیریت می شود.
  • USER_TYPE_UNMANAGED : کاربر توسط دامنه مدیریت نمی شود.
recentUsers[].email

string

آدرس ایمیل کاربر. این فقط در صورتی وجود دارد که نوع کاربر USER_TYPE_MANAGED باشد.

activeTimeRanges[]

object

فهرستی از محدوده زمانی فعال (فقط خواندنی).

activeTimeRanges[].activeTime

integer

مدت زمان استفاده بر حسب میلی ثانیه

activeTimeRanges[].date

string

تاریخ استفاده.

ethernetMacAddress

string

آدرس MAC دستگاه در رابط شبکه اترنت.

annotatedAssetId

string

شناسه دارایی همانطور که توسط یک مدیر ذکر شده است یا در هنگام ثبت نام مشخص شده است.

etag

string

ETag منبع

diskVolumeReports[]

object

گزارش فضای دیسک و سایر اطلاعات در مورد ولوم های نصب شده/متصل.

diskVolumeReports[].volumeInfo[]

object

حجم های دیسک

diskVolumeReports[].volumeInfo[].volumeId

string

شناسه حجم

diskVolumeReports[].volumeInfo[].storageTotal

string ( int64 format)

کل فضای دیسک [بر حسب بایت]

diskVolumeReports[].volumeInfo[].storageFree

string ( int64 format)

فضای خالی دیسک [بر حسب بایت]

systemRamTotal

string ( int64 format)

کل RAM دستگاه بر حسب بایت

cpuStatusReports[]

object

گزارش استفاده از CPU و دما (فقط خواندنی)

cpuStatusReports[].reportTime

string

تاریخ و ساعت دریافت گزارش

cpuStatusReports[].cpuUtilizationPercentageInfo[]

integer

cpuStatusReports[].cpuTemperatureInfo[]

object

لیستی از نمونه های دمای CPU

cpuStatusReports[].cpuTemperatureInfo[].temperature

integer

دما بر حسب درجه سانتیگراد.

cpuStatusReports[].cpuTemperatureInfo[].label

string

برچسب CPU

cpuInfo[]

object

اطلاعات مربوط به مشخصات CPU در دستگاه.

cpuInfo[].model

string

نام مدل CPU

cpuInfo[].architecture

string

معماری CPU

cpuInfo[].maxClockSpeedKhz

integer

حداکثر سرعت کلاک CPU بر حسب کیلوهرتز.

cpuInfo[].logicalCpus[]

object

اطلاعات برای CPU های منطقی

cpuInfo[].logicalCpus[].maxScalingFrequencyKhz

integer

حداکثر فرکانسی که CPU مجاز به اجرا در آن است، بر اساس سیاست.

cpuInfo[].logicalCpus[].currentScalingFrequencyKhz

integer

فرکانس فعلی CPU در حال کار است.

cpuInfo[].logicalCpus[].idleDuration

string ( Duration format)

زمان بیکار از آخرین بوت.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

cpuInfo[].logicalCpus[].cStates[]

object

C-State وضعیت مصرف انرژی CPU را نشان می دهد. برای اطلاعات بیشتر به اسناد منتشر شده توسط سازنده CPU نگاه کنید.

cpuInfo[].logicalCpus[].cStates[].displayName

string

نام ایالت.

cpuInfo[].logicalCpus[].cStates[].sessionDuration

string ( Duration format)

زمان صرف شده در ایالت از آخرین راه‌اندازی مجدد.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

deviceFiles[]

object

لیستی از فایل های دستگاه برای دانلود (فقط خواندنی)

deviceFiles[].name

string

نام فایل

deviceFiles[].type

string

نوع فایل

deviceFiles[].downloadUrl

string

آدرس دانلود فایل

deviceFiles[].createTime

string

تاریخ و زمان ایجاد فایل

systemRamFreeReports[]

object

گزارش مقدار حافظه رم موجود (فقط خواندنی)

systemRamFreeReports[].reportTime

string

تاریخ و ساعت دریافت گزارش

systemRamFreeReports[].systemRamFreeInfo[]

string ( int64 format)

lastKnownNetwork[]

object

حاوی آخرین شبکه شناخته شده (فقط خواندنی)

lastKnownNetwork[].ipAddress

string

آدرس IP.

lastKnownNetwork[].wanIpAddress

string

آدرس IP WAN.

autoUpdateExpiration

string ( int64 format)

(فقط خواندنی) مهر زمانی که پس از آن دستگاه دریافت به‌روزرسانی‌ها یا پشتیبانی Chrome را متوقف می‌کند

ethernetMacAddress0

string

آدرس MAC (فقط خواندنی) که توسط درگاه اترنت داخلی Chromebook و برای رابط شبکه داخلی (اترنت) استفاده می‌شود. قالب دوازده (12) رقم هگزادسیمال بدون هیچ گونه جداکننده (حروف بزرگ) است. این فقط برای برخی از دستگاه ها مرتبط است.

dockMacAddress

string

(فقط خواندنی) آدرس MAC داخلی برای ایستگاه اتصالی که دستگاه به آن متصل است. کارخانه آدرس کنترل دسترسی رسانه (آدرس MAC) را که برای استفاده توسط یک داک اختصاص داده شده است، تنظیم می کند. این به طور خاص برای سیاست عبور دستگاه MAC رزرو شده است. قالب دوازده (12) رقم هگزادسیمال بدون هیچ گونه جداکننده (حروف بزرگ) است. این فقط برای برخی از دستگاه ها مرتبط است.

manufactureDate

string

(فقط خواندنی) تاریخی که دستگاه در قالب yyyy-mm-dd ساخته شده است.

orgUnitPath

string

مسیر کامل والدین با نام واحد سازمانی مرتبط با دستگاه. نام مسیرها به حروف بزرگ و کوچک حساس نیستند. اگر واحد سازمانی والد سازمان سطح بالا باشد، به صورت اسلش رو به جلو نشان داده می شود، / . این ویژگی را می توان با استفاده از API به روز کرد. برای اطلاعات بیشتر درباره نحوه ایجاد یک ساختار سازمانی برای دستگاه خود، به مرکز راهنمایی مدیریت مراجعه کنید.

tpmVersionInfo

object

ماژول پلتفرم مورد اعتماد (TPM) (فقط خواندنی)

tpmVersionInfo.family

string

خانواده TPM ما از رمزگذاری سبک TPM 2.0 استفاده می کنیم، به عنوان مثال:
TPM 1.2: "1.2" -> 312e3200
TPM 2.0: "2.0" -> 322e3000

tpmVersionInfo.specLevel

string

سطح مشخصات TPM مشخصات کتابخانه برای TPM 2.0 و مشخصات اصلی برای TPM 1.2 را ببینید.

tpmVersionInfo.manufacturer

string

کد سازنده TPM

tpmVersionInfo.tpmModel

string

شماره مدل TPM

tpmVersionInfo.firmwareVersion

string

نسخه سیستم عامل TPM.

tpmVersionInfo.vendorSpecific

string

اطلاعات خاص فروشنده مانند شناسه فروشنده.

screenshotFiles[]

object

لیستی از فایل های اسکرین شات برای دانلود. نوع همیشه "SCREENSHOT_FILE" است. (فقط خواندنی)

screenshotFiles[].name

string

نام فایل

screenshotFiles[].type

string

نوع فایل

screenshotFiles[].downloadUrl

string

آدرس دانلود فایل

screenshotFiles[].createTime

string

تاریخ و زمان ایجاد فایل

orgUnitId

string

شناسه منحصر به فرد واحد سازمانی. orgUnitPath نسخه قابل خواندن orgUnitId توسط انسان است. در حالی که orgUnitPath ممکن است با تغییر نام یک واحد سازمانی در مسیر تغییر کند، orgUnitId برای یک واحد سازمانی غیر قابل تغییر است. این ویژگی را می توان با استفاده از API به روز کرد. برای اطلاعات بیشتر درباره نحوه ایجاد یک ساختار سازمانی برای دستگاه خود، به مرکز راهنمایی مدیریت مراجعه کنید.

osUpdateStatus

object ( OsUpdateStatus )

وضعیت به روز رسانی سیستم عامل برای دستگاه.

firstEnrollmentTime

string

تاریخ و زمان برای اولین بار ثبت نام دستگاه.

lastDeprovisionTimestamp

string

(فقط خواندنی) تاریخ و زمان آخرین تحویل دستگاه.

deprovisionReason

enum ( DeprovisionReason )

(فقط خواندنی) دلیل محرومیت.

deviceLicenseType

enum ( DeviceLicenseType )

فقط خروجی نوع مجوز دستگاه

backlightInfo[]

object ( BacklightInfo )

فقط خروجی حاوی اطلاعات نور پس زمینه دستگاه است.

OsUpdateStatus

حاوی اطلاعات مربوط به وضعیت فعلی به روز رسانی سیستم عامل است.

نمایندگی JSON
{
  "state": enum (UpdateState),
  "targetOsVersion": string,
  "targetKioskAppVersion": string,
  "updateTime": string,
  "updateCheckTime": string,
  "rebootTime": string
}
زمینه های
state

enum ( UpdateState )

وضعیت به روز رسانی یک به روز رسانی سیستم عامل.

targetOsVersion

string

نسخه پلتفرم جدید تصویر سیستم عامل در حال دانلود و اعمال است. فقط زمانی تنظیم می‌شود که وضعیت به‌روزرسانی UPDATE_STATUS_DOWNLOAD_IN_PROGRESS یا UPDATE_STATUS_NEED_REBOOT باشد. توجه داشته باشید که این می تواند یک "0.0.0.0" ساختگی برای UPDATE_STATUS_NEED_REBOOT برای برخی از موارد لبه باشد، به عنوان مثال موتور به روز رسانی بدون راه اندازی مجدد راه اندازی مجدد می شود.

targetKioskAppVersion

string

نسخه جدید پلت فرم مورد نیاز از برنامه کیوسک به روز شده در حال انتظار.

updateTime

string

تاریخ و زمان آخرین به روز رسانی موفق سیستم عامل.

updateCheckTime

string

تاریخ و زمان آخرین بررسی به‌روزرسانی.

rebootTime

string

تاریخ و زمان آخرین راه اندازی مجدد

UpdateState

وضعیت به روز رسانی یک به روز رسانی سیستم عامل.

Enums
UPDATE_STATE_UNSPECIFIED وضعیت به روز رسانی نامشخص است.
UPDATE_STATE_NOT_STARTED یک به روز رسانی در انتظار وجود دارد اما شروع نشده است.
UPDATE_STATE_DOWNLOAD_IN_PROGRESS به‌روزرسانی معلق در حال دانلود است.
UPDATE_STATE_NEED_REBOOT دستگاه آماده نصب به‌روزرسانی است، اما باید راه‌اندازی مجدد شود.

DeprovisionReason

دلیل عدم ارائه یک دستگاه ChromeOS.

Enums
DEPROVISION_REASON_UNSPECIFIED دلیل محرومیت نامشخص است.
DEPROVISION_REASON_SAME_MODEL_REPLACEMENT تعویض همون مدل شما دارای مجوز بازگشت مواد (RMA) هستید یا در حال تعویض دستگاه خراب تحت گارانتی با همان مدل دستگاه هستید.
DEPROVISION_REASON_UPGRADE

دستگاه ارتقا یافت.

DEPROVISION_REASON_DOMAIN_MOVE

دامنه دستگاه تغییر کرد.

DEPROVISION_REASON_SERVICE_EXPIRATION

سرویس برای دستگاه منقضی شده است.

DEPROVISION_REASON_OTHER

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

DEPROVISION_REASON_DIFFERENT_MODEL_REPLACEMENT جایگزینی مدل های مختلف شما در حال جایگزینی این دستگاه با یک مدل دستگاه ارتقا یافته یا جدیدتر هستید.
DEPROVISION_REASON_RETIRING_DEVICE بازنشستگی از ناوگان شما در حال اهدا، دور انداختن یا حذف دستگاه از استفاده هستید.
DEPROVISION_REASON_UPGRADE_TRANSFER انتقال ارتقاء ChromeOS Flex. این یک دستگاه ChromeOS Flex است که ظرف یک سال آن را با Chromebook جایگزین می‌کنید.
DEPROVISION_REASON_NOT_REQUIRED دلیلی لازم نبود به عنوان مثال، مجوزها به استخر مجوز مشتری بازگردانده شد.
DEPROVISION_REASON_REPAIR_CENTER دستگاه توسط مرکز خدمات تعمیرات خارج شده است. فقط می تواند توسط مرکز خدمات تعمیر در طول RMA تنظیم شود.

DeviceLicenseType

نوع مجوز این دستگاه

Enums
DEVICE_LICENSE_TYPE_UNSPECIFIED نوع مجوز مشخص نیست.
ENTERPRISE دستگاه همراه با ارتقای دائمی Chrome Enterprise است.
ENTERPRISE_UPGRADE این دستگاه دارای ارتقاء سالانه Chrome Enterprise مستقل است.
EDUCATION_UPGRADE این دستگاه دارای ارتقای آموزش Chrome مستقل دائمی است.
EDUCATION این دستگاه با ارتقای دائمی آموزش Chrome همراه است.
KIOSK_UPGRADE این دستگاه دارای ارتقا سالانه کیوسک است.

BacklightInfo

اطلاعاتی در مورد نور پس زمینه دستگاه.

نمایندگی JSON
{
  "path": string,
  "maxBrightness": integer,
  "brightness": integer
}
زمینه های
path

string

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

maxBrightness

integer

فقط خروجی حداکثر روشنایی برای نور پس زمینه

brightness

integer

فقط خروجی روشنایی فعلی نور پس زمینه، بین 0 و حداکثر روشنایی.

مواد و روش ها

action
(deprecated)

 به جای آن از BatchChangeChromeOsDeviceStatus استفاده کنید.

get

 ویژگی های دستگاه سیستم عامل Chrome را بازیابی می کند.

list

 فهرست صفحه بندی شده ای از دستگاه های سیستم عامل Chrome را در یک حساب بازیابی می کند.

moveDevicesToOu

 چندین دستگاه سیستم عامل Chrome را به یک واحد سازمانی منتقل یا درج می کند.

patch

 ویژگی‌های قابل به‌روزرسانی دستگاه، مانند annotatedUser ، annotatedLocation ، notes ، orgUnitPath یا annotatedAssetId را به‌روزرسانی می‌کند.

update

 ویژگی‌های قابل به‌روزرسانی دستگاه، مانند annotatedUser ، annotatedLocation ، notes ، orgUnitPath یا annotatedAssetId را به‌روزرسانی می‌کند.