REST Resource: chromeosdevices

Kaynak: ChromeOsDevice

Google Chrome cihazları Chrome OS üzerinde çalışır. Yaygın API görevleri hakkında daha fazla bilgi için Geliştirici Kılavuzu'na bakın.

JSON gösterimi
{
  "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)
    }
  ],
  "autoUpdateThrough": string,
  "extendedSupportEligible": boolean,
  "extendedSupportStart": string,
  "extendedSupportEnabled": boolean,
  "fanInfo": [
    {
      object (FanInfo)
    }
  ],
  "chromeOsType": enum (ChromeOsType)
}
Alanlar
deviceId

string

Chrome cihazın benzersiz kimliği.

serialNumber

string

Cihaz etkinleştirildiğinde girilen Chrome cihazın seri numarası. Bu değer, Chrome OS Cihazlar sekmesindeki Yönetici konsolunun Seri Numarası ile aynıdır.

status

string

Cihazın durumu.

Kabul edilebilir değerler şunlardır:

  • ACTIVE: Cihaz, alana kaydettirilmiştir.
  • DELINQUENT: Alanın yıllık lisansının süresi doldu ve cihaz artık politikaları ve ayarları almıyor. Yeni bir lisans satın alındığında cihaz ACTIVE durumuna döner.
  • PRE_PROVISIONED: Cihaz el değmeden kayıt için kaydedilmiştir. PRE_PROVISIONED cihazları farklı bir kuruluş birimine taşınabilir veya silinebilir. Kayıt işlemi tamamlandıktan sonra cihaz ACTIVE olacak.
  • DEPROVISIONED: Cihaz artık bu alana kaydettirilmeye uygun değil. Sipariş iptal edildi. Cihazın ayarları cihazda önbelleğe alınmış. Cihaz tekrar etkinleştirilirse yeni etkinleştirilen bu cihaza en son sistem ayarları uygulanır.
  • DISABLED: Cihaz yönetici tarafından devre dışı bırakıldı ve kullanılamaz.
  • INACTIVE: Cihaz, alana kayıtlı değildir.
  • RETURN_ARRIVED: Bu cihazı değiştirme isteği gönderildi.
  • RETURN_REQUESTED: Bu cihazın değiştirilmesi için bir istek gönderildi.
  • SHIPPED: Cihaz, Google envanterinden gönderilir. (Kullanımdan kaldırıldı)
  • UNKNOWN: Cihazın durumu belirlenemiyor.
lastSync

string

Cihazın, Yönetici Konsolu'ndaki politika ayarlarıyla son senkronize edildiği tarih ve saat. Değer, ISO 8601 tarih ve saat biçimindedir. Saat, YYYY-MM-DDThh:mm:ssTZD biçiminde tam tarih artı saat, dakika ve saniyedir. Örneğin, 2010-04-05T17:30:04+01:00.

supportEndDate

string

Cihazın destekleneceği son tarih. Bu yalnızca doğrudan Google'dan satın alınan cihazlar için geçerlidir. Değer, ISO 8601 tarih ve saat biçimindedir. Saat, YYYY-MM-DDThh:mm:ssTZD biçiminde tam tarih artı saat, dakika ve saniyedir. Örneğin, 2010-04-05T17:30:04+01:00.

annotatedUser

string

Yönetici tarafından belirtilen şekilde cihazın kullanıcısı. Maksimum uzunluk 100 karakterdir. Boş değerlere izin verilir.

annotatedLocation

string

Cihazın yönetici tarafından belirtilen adresi veya konumu. Maksimum uzunluk 200 karakterdir. Boş değerlere izin verilir.

notes

string

Bu cihazla ilgili notlar yönetici tarafından eklendi. Bu mülk, list yönteminin query parametresiyle aranabilir. Maksimum uzunluk 500 karakterdir. Boş değerlere izin verilir.

model

string

Cihazın model bilgileri. Cihazda bu bilgiler yoksa bu özellik yanıta dahil edilmez.

meid

string

Bir mobil cihazdaki 3G mobil kartının Mobil Cihaz Kimliği (MEID) veya Uluslararası Mobil Cihaz Kimliği (IMEI). MEID/IMEI genellikle bir cihazı kablosuz operatörün sonradan ödeme hizmet planına eklerken kullanılır. Cihazda bu bilgiler yoksa bu özellik yanıta dahil edilmez. MEID/IMEI listesini dışa aktarma hakkında daha fazla bilgi edinmek için Geliştirici Kılavuzu'na bakın.

orderNumber

string

Cihazın sipariş numarası. Yalnızca doğrudan Google'dan satın alınan cihazların sipariş numarası bulunur.

willAutoRenew

boolean

Cihazın, destek bitiş tarihinden sonra desteğini otomatik olarak yenileyip yenilemeyeceğini belirler. Bu, salt okunur bir özelliktir.

osVersion

string

Chrome cihazın işletim sistemi sürümü.

platformVersion

string

Chrome cihazın platform sürümü.

firmwareVersion

string

Chrome cihazın donanım yazılımı sürümü.

macAddress

string

Cihazın kablosuz MAC adresi. Cihazda bu bilgiler yoksa yanıta dahil edilmez.

bootMode

string

Cihazın başlatma modu. Olası değerler şunlardır:

  • Verified: Cihazda Chrome OS'in geçerli bir sürümü yüklüdür.
  • Dev: Cihazların geliştirici donanım anahtarı etkin. Cihaz başlatıldığında bir komut satırı kabuğu olur. Geliştirici anahtarı örneği için Chromebook geliştirici bilgilerine göz atın.
lastEnrollmentTime

string

Cihazın son kaydedildiği tarih ve saat. Değer, ISO 8601 tarih ve saat biçimindedir. Saat, YYYY-MM-DDThh:mm:ssTZD biçiminde tam tarih artı saat, dakika ve saniyedir. Örneğin, 2010-04-05T17:30:04+01:00. Otomatik ve manuel kayıt hakkında daha fazla bilgi edinmek için Chrome yardım merkezine göz atın.

kind

string

Kaynağın türü. Chromeosdevices kaynağı için değer admin#directory#chromeosdevice şeklindedir.

recentUsers[]

object

Son giriş zamanına göre son cihaz kullanıcılarının listesi, azalan sırayla.

recentUsers[].type

string

Kullanıcının türü.

Kabul edilebilir değerler şunlardır:

  • USER_TYPE_MANAGED: Kullanıcı, alan tarafından yönetilir.
  • USER_TYPE_UNMANAGED: Kullanıcı, alan adı tarafından yönetilmiyor.
recentUsers[].email

string

Kullanıcının e-posta adresi. Bu yalnızca kullanıcı türü USER_TYPE_MANAGED olduğunda mevcuttur.

activeTimeRanges[]

object

Etkin zaman aralıklarının listesi (Salt okunur).

activeTimeRanges[].activeTime

integer

Milisaniye cinsinden kullanım süresi.

activeTimeRanges[].date

string

Kullanım tarihi.

ethernetMacAddress

string

Cihazın ethernet ağ arayüzündeki MAC adresi.

annotatedAssetId

string

Yönetici tarafından not edildiği veya kayıt sırasında belirtilen öğe tanımlayıcısı.

etag

string

Kaynağın eTag'i.

diskVolumeReports[]

object

Disk alanı raporları ve eklenen/bağlı birimlerle ilgili diğer bilgiler.

diskVolumeReports[].volumeInfo[]

object

Disk birimleri

diskVolumeReports[].volumeInfo[].volumeId

string

Cilt kimliği

diskVolumeReports[].volumeInfo[].storageTotal

string (int64 format)

Toplam disk alanı [bayt cinsinden]

diskVolumeReports[].volumeInfo[].storageFree

string (int64 format)

Boş disk alanı [bayt cinsinden]

systemRamTotal

string (int64 format)

Cihazdaki toplam RAM bayt cinsinden

cpuStatusReports[]

object

CPU kullanımı ve sıcaklığı raporları (Salt okunur)

cpuStatusReports[].reportTime

string

Raporun alındığı tarih ve saat.

cpuStatusReports[].cpuUtilizationPercentageInfo[]

integer

cpuStatusReports[].cpuTemperatureInfo[]

object

CPU sıcaklığı örneklerinin listesi.

cpuStatusReports[].cpuTemperatureInfo[].temperature

integer

Santigrat derece cinsinden sıcaklık.

cpuStatusReports[].cpuTemperatureInfo[].label

string

CPU etiketi

cpuInfo[]

object

Cihazdaki CPU özellikleriyle ilgili bilgiler.

cpuInfo[].model

string

CPU model adı.

cpuInfo[].architecture

string

CPU mimarisi.

cpuInfo[].maxClockSpeedKhz

integer

Maksimum CPU saat hızı (kHz).

cpuInfo[].logicalCpus[]

object

Mantıksal CPU bilgileri

cpuInfo[].logicalCpus[].maxScalingFrequencyKhz

integer

Politikaya göre CPU'nun çalışmasına izin verilen maksimum frekans.

cpuInfo[].logicalCpus[].currentScalingFrequencyKhz

integer

CPU'nun çalıştığı mevcut frekans.

cpuInfo[].logicalCpus[].idleDuration

string (Duration format)

Son başlatmadan bu yana boşta kalma süresi.

En fazla dokuz kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

cpuInfo[].logicalCpus[].cStates[]

object

C-Durumları, CPU'nun güç tüketimi durumunu gösterir. Daha fazla bilgi için CPU üreticisi tarafından yayınlanan belgelere bakın.

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

string

Eyaletin adı.

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

string (Duration format)

Son yeniden başlatmadan bu yana durumda harcanan süre.

En fazla dokuz kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

deviceFiles[]

object

İndirilecek cihaz dosyalarının listesi (Salt okunur)

deviceFiles[].name

string

Dosya adı

deviceFiles[].type

string

Dosya türü

deviceFiles[].downloadUrl

string

Dosya indirme URL'si

deviceFiles[].createTime

string

Dosyanın oluşturulduğu tarih ve saat

systemRamFreeReports[]

object

Kullanılabilir RAM belleği miktarlarının raporları (Salt okunur)

systemRamFreeReports[].reportTime

string

Raporun alındığı tarih ve saat.

systemRamFreeReports[].systemRamFreeInfo[]

string (int64 format)

lastKnownNetwork[]

object

Bilinen son ağı içerir (Salt okunur)

lastKnownNetwork[].ipAddress

string

IP adresi.

lastKnownNetwork[].wanIpAddress

string

WAN IP adresi.

autoUpdateExpiration
(deprecated)

string (int64 format)

(Salt okunur) Cihazın, Chrome güncellemelerini veya desteği almayı bırakacağı zaman damgası. Lütfen "autoUpdateThrough"yu kullanın. .

ethernetMacAddress0

string

Chromebook'un dahili ethernet bağlantı noktası ve tümleşik ağ (ethernet) arayüzü için kullanılan (salt okunur) MAC adresi. Biçim, ayırıcı olmayan (büyük harf) on iki (12) on altılı basamaktır. Bu yalnızca bazı cihazlarda geçerlidir.

dockMacAddress

string

(Salt okunur) Cihazın bağlandığı bağlantı istasyonu için yerleşik MAC adresi. Fabrika ayarları, bir yuva tarafından kullanılmak üzere atanan Medya erişim denetimi adresini (MAC adresi) ayarlar. Özellikle MAC geçiş cihaz politikası için ayrılmıştır. Biçim, ayırıcı olmayan (büyük harf) on iki (12) on altılı basamaktır. Bu yalnızca bazı cihazlarda geçerlidir.

manufactureDate

string

(Salt okunur) yyyy-aa-gg biçiminde cihazın üretildiği tarih.

orgUnitPath

string

Cihazla ilişkilendirilmiş kuruluş biriminin adıyla birlikte tam üst yol. Yol adları büyük/küçük harfe duyarlı değildir. Üst kuruluş birimi üst düzey kuruluşsa öne eğik çizgi (/) ile gösterilir. Bu özellik, API kullanılarak güncellenebilir. Cihazınız için bir kuruluş yapısı oluşturma konusunda daha fazla bilgi edinmek için yönetim yardım merkezine bakın.

tpmVersionInfo

object

Güvenilir Platform Modülü (TPM) (Salt okunur)

tpmVersionInfo.family

string

TPM ailesi. TPM 2.0 stil kodlamasını kullanırız. Örneğin:
TPM 1.2: "1,2" -> 312e3200
TPM 2.0: "2,0" -> 322e3000

tpmVersionInfo.specLevel

string

TPM spesifikasyon düzeyi. TPM 2.0 için Kitaplık Spesifikasyonu ve TPM 1.2 için Ana Spesifikasyonu inceleyin.

tpmVersionInfo.manufacturer

string

TPM üretici kodu.

tpmVersionInfo.tpmModel

string

TPM model numarası.

tpmVersionInfo.firmwareVersion

string

TPM donanım yazılımı sürümü.

tpmVersionInfo.vendorSpecific

string

Tedarikçi firma kimliği gibi tedarikçi firmaya özel bilgiler.

screenshotFiles[]

object

İndirilecek ekran görüntüsü dosyalarının listesi. Tür her zaman "SCREENSHOT_FILE" olur. (Salt okunur)

screenshotFiles[].name

string

Dosya adı

screenshotFiles[].type

string

Dosya türü

screenshotFiles[].downloadUrl

string

Dosya indirme URL'si

screenshotFiles[].createTime

string

Dosyanın oluşturulduğu tarih ve saat

orgUnitId

string

Kuruluş biriminin benzersiz kimliği. orgUnitPath, orgUnitId'nin kullanıcılar tarafından okunabilen sürümüdür. orgUnitPath, yol içindeki bir kuruluş birimini yeniden adlandırarak değişebilse de tek bir kuruluş birimi için orgUnitId değiştirilemez. Bu özellik, API kullanılarak güncellenebilir. Cihazınız için bir kuruluş yapısı oluşturma konusunda daha fazla bilgi edinmek için yönetim yardım merkezine bakın.

osUpdateStatus

object (OsUpdateStatus)

Cihazın işletim sistemi güncellemelerinin durumu.

firstEnrollmentTime

string

Cihazın ilk kez kaydedildiği tarih ve saat.

lastDeprovisionTimestamp

string

(Salt okunur) Cihazın son temel hazırlığının kaldırıldığı tarih ve saat.

deprovisionReason

enum (DeprovisionReason)

(Salt okunur) Temel hazırlığı kaldırma nedeni.

deviceLicenseType

enum (DeviceLicenseType)

Yalnızca çıkış. Cihaz lisans türü.

backlightInfo[]

object (BacklightInfo)

Yalnızca çıkış. Cihazın arka ışık bilgilerini içerir.

autoUpdateThrough

string

Yalnızca çıkış. Cihazın Chrome güncellemelerini veya desteği almayı bırakacağı zaman damgası.

extendedSupportEligible

boolean

Yalnızca çıkış. Cihazda genişletilmiş destek etkinleştirmesinin gerekip gerekmediği.

extendedSupportStart

string

Yalnızca çıkış. Otomatik güncellemeler için genişletilmiş destek politikasının başladığı cihazın tarihi.

extendedSupportEnabled

boolean

Yalnızca çıkış. Cihazda genişletilmiş destek politikasının etkin olup olmadığı.

fanInfo[]

object (FanInfo)

Yalnızca çıkış. Cihazın fan bilgileri.

chromeOsType

enum (ChromeOsType)

Yalnızca çıkış. Cihazın Chrome OS türü.

OsUpdateStatus

Mevcut işletim sisteminin güncelleme durumuyla ilgili bilgileri içerir.

JSON gösterimi
{
  "state": enum (UpdateState),
  "targetOsVersion": string,
  "targetKioskAppVersion": string,
  "updateTime": string,
  "updateCheckTime": string,
  "rebootTime": string
}
Alanlar
state

enum (UpdateState)

Bir işletim sistemi güncellemesinin güncelleme durumu.

targetOsVersion

string

İndirilmekte ve uygulanan OS görüntüsünün yeni platform sürümü. Yalnızca güncelleme durumu UPDATE_STATUS_download_IN_PROGRESS veya UPDATE_STATUS_NEED_REBOOT olduğunda ayarlanır. Bunun bir kukla "0.0.0.0" olabileceğini unutmayın bazı uç durumlarda UPDATE_STATUS_NEED_REBOOT için güncelleme motoru yeniden başlatılmadan yeniden başlatılır.

targetKioskAppVersion

string

Beklemede olan güncellenmiş kiosk uygulamasından, gerekli yeni platform sürümü.

updateTime

string

Son başarılı işletim sistemi güncellemesinin tarih ve saati.

updateCheckTime

string

Son güncelleme kontrolünün tarih ve saati.

rebootTime

string

Son yeniden başlatmanın tarih ve saati.

UpdateState

Bir işletim sistemi güncellemesinin güncelleme durumu.

Sıralamalar
UPDATE_STATE_UNSPECIFIED Güncelleme durumu belirtilmemiş.
UPDATE_STATE_NOT_STARTED Bekleyen bir güncelleme var, ancak başlamadı.
UPDATE_STATE_DOWNLOAD_IN_PROGRESS Beklemedeki güncelleme indiriliyor.
UPDATE_STATE_NEED_REBOOT Cihaz güncellemeyi yüklemeye hazır, ancak yeniden başlatılması gerekiyor.

DeprovisionReason

Bir ChromeOS cihazın temel hazırlığının kaldırılma nedeni.

Sıralamalar
DEPROVISION_REASON_UNSPECIFIED Temel hazırlığı kaldırma nedeni bilinmiyor.
DEPROVISION_REASON_SAME_MODEL_REPLACEMENT Aynı modelle değiştirme. Malzeme iade onayınız (RMA) varsa veya hatalı cihazınızı garanti kapsamında aynı cihazın yenisiyle değiştiriyorsanız
DEPROVISION_REASON_UPGRADE

Cihaz yeni sürüme geçirildi.

DEPROVISION_REASON_DOMAIN_MOVE

Cihazın alan adı değiştirildi.

DEPROVISION_REASON_SERVICE_EXPIRATION

Cihazla ilgili hizmetin süresi doldu.

DEPROVISION_REASON_OTHER

Artık desteklenmeyen eski bir nedenden dolayı cihazın temel hazırlığı kaldırıldı.

DEPROVISION_REASON_DIFFERENT_MODEL_REPLACEMENT Farklı model değişimi. Cihazı yeni veya daha güçlü bir modelle değiştiriyorsanız
DEPROVISION_REASON_RETIRING_DEVICE Filodan çıkarma. Cihazı bağışlıyor, atıyor veya başka bir şekilde kullanımdan kaldırıyorsanız
DEPROVISION_REASON_UPGRADE_TRANSFER ChromeOS Flex yükseltme aktarımı. Bir yıl içinde Chromebook ile değiştireceğiniz bir ChromeOS Flex cihazı söz konusuysa
DEPROVISION_REASON_NOT_REQUIRED Neden belirtilmemiş. Örneğin, lisanslar müşterinin lisans havuzuna iade edilmiştir.
DEPROVISION_REASON_REPAIR_CENTER Cihazın Onarım Hizmeti Merkezi tarafından temel hazırlığı kaldırıldı. Yalnızca RMA sırasında Onarım Servis Merkezi tarafından ayarlanabilir.

DeviceLicenseType

Bu cihazın lisans türü.

Sıralamalar
DEVICE_LICENSE_TYPE_UNSPECIFIED Lisans türü bilinmiyor.
ENTERPRISE Cihaz, daimi bir Chrome Enterprise Yükseltme lisansıyla paket halinde sunulur.
ENTERPRISE_UPGRADE Cihazın yıllık bağımsız Chrome Enterprise Yükseltme lisansı vardır.
EDUCATION_UPGRADE Cihazda, kalıcı ve bağımsız bir Chrome Education Yükseltme lisansı vardır.
EDUCATION Cihaz, kalıcı bir Chrome Education Yükseltme lisansıyla paket halinde sunulur.
KIOSK_UPGRADE Cihazda yıllık Kiosk Yükseltmesi vardır.

BacklightInfo

Cihazın arka ışıklarıyla ilgili bilgiler.

JSON gösterimi
{
  "path": string,
  "maxBrightness": integer,
  "brightness": integer
}
Alanlar
path

string

Yalnızca çıkış. Sistemdeki bu arka ışığa giden yol. Arayanın diğer bilgilerle ilişkilendirilmesi gerekiyorsa yararlıdır.

maxBrightness

integer

Yalnızca çıkış. Arka ışık için maksimum parlaklık.

brightness

integer

Yalnızca çıkış. Arka ışığın mevcut parlaklığı; 0 ile maxPrightness arasında.

FanInfo

Cihazın fanıyla ilgili bilgiler.

JSON gösterimi
{
  "speedRpm": integer
}
Alanlar
speedRpm

integer

Yalnızca çıkış. Fan hızı (BGBG)

ChromeOsType

Cihazın Chrome OS türü.

Sıralamalar
CHROME_OS_TYPE_UNSPECIFIED Chrome OS Türü belirtilmedi.
CHROME_OS_FLEX Chrome OS türü: ChromeOS Flex.
CHROME_OS Chrome OS türü Chrome OS.

Yöntemler

action
(deprecated)

Bunun yerine BatchChangeChromeOsDeviceStatus öğesini kullanın.

get

Chrome OS cihazın özelliklerini alır.

list

Bir hesaptaki Chrome OS cihazların sayfalara ayrılmış listesini alır.

moveDevicesToOu

Bir kuruluş birimine birden fazla Chrome OS cihazı taşır veya ekler.

patch

Cihazın annotatedUser, annotatedLocation, notes, orgUnitPath veya annotatedAssetId gibi güncellenebilir özelliklerini günceller.

update

Cihazın annotatedUser, annotatedLocation, notes, orgUnitPath veya annotatedAssetId gibi güncellenebilir özelliklerini günceller.