REST Resource: chromeosdevices

Kaynak: ChromeOsDevice

Google Chrome cihazları Chrome OS işletim sisteminde çalışır. Sık kullanılan API görevleri hakkında daha fazla bilgi edinmek için Geliştirici Kılavuzu'na göz atı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)
    }
  ]
}
Alanlar
deviceId

string

Chrome cihazın benzersiz kimliği.
serialNumber

string

Cihaz etkinleştirilirken girilen Chrome cihaz seri numarası. Bu değer, Chrome OS Cihazlar sekmesinde yer alan, Yönetici konsolunun Seri Numarası ile aynıdır.
status

string

Cihazın durumu.

Kabul edilebilir değerler şunlardır:

  • ACTIVE: Cihaz, alana kaydedildi.
  • DELINQUENT: Alanın yıllık lisansının süresi dolduğundan 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 kaydedildi. PRE_PROVISIONED cihaz farklı bir kuruluş birimine taşınabilir veya silinebilir. Kayıt tamamlandığında cihaz ACTIVE olacak.
  • DEPROVISIONED: Cihaz artık alana kaydedilmeye uygun değildir. Sipariş iptal edildi. Cihazın ayarları cihazda önbelleğe alındı. Cihaz tekrar etkinleştirilirse, yeni etkinleştirilen cihaza en son sistem ayarları uygulanır.
  • DISABLED: Cihaz yönetici tarafından devre dışı bırakıldı ve kullanılamaz.
  • INACTIVE: Cihaz, alan adına kayıtlı değil.
  • RETURN_ARRIVED: Bu cihazı değiştirme isteği alındı.
  • RETURN_REQUESTED: Bu cihazın değiştirilmesi için istekte bulunuldu.
  • SHIPPED: Cihaz, Google envanterinden gönderilmiştir. (Kullanımdan kaldırıldı)
  • UNKNOWN: Cihazın durumu belirlenemiyor.
lastSync

string

Cihazın, Yönetici konsolundaki politika ayarlarıyla son senkronize edildiği tarih ve saat. Bu değer, ISO 8601 tarih ve saat biçimindedir. Saat, tam tarihin yanı sıra YYYY-MM-DDThh:mm:ssTZD biçiminde 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. Bu değer, ISO 8601 tarih ve saat biçimindedir. Saat, tam tarihin yanı sıra YYYY-MM-DDThh:mm:ssTZD biçiminde saat, dakika ve saniyedir. Örneğin, 2010-04-05T17:30:04+01:00.
annotatedUser

string

Yönetici tarafından belirtilen cihaz 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 olarak yönetici tarafından eklenen notlar. Bu özellik, 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 Ekipman Kimliği (MEID) veya Uluslararası Mobil Ekipman Kimliği (IMEI). MEID/IMEI genellikle bir kablosuz operatörün sonradan ödeme hizmeti planına cihaz 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 göz atın.
orderNumber

string

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

boolean

Destek bitiş tarihinden sonra cihazın desteğinin otomatik olarak yenilenip yenilenmeyeceğ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 bu bilgiler yanıta dahil edilmez.
bootMode

string

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

  • Verified: Cihaz Chrome OS'in geçerli bir sürümünü çalıştırıyor.
  • Dev: Cihazların geliştirici donanım anahtarı etkin. Başlatıldığında cihazın bir komut satırı kabuğu bulunur. Geliştirici anahtarına ilişkin bir örnek için Chromebook geliştirici bilgileri bölümüne bakın.
lastEnrollmentTime

string

Cihazın son kaydettirildiği tarih ve saat. Bu değer, ISO 8601 tarih ve saat biçimindedir. Saat, tam tarihin yanı sıra YYYY-MM-DDThh:mm:ssTZD biçiminde 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'dir.
recentUsers[]

object

Son giriş zamanına göre, en son cihaz kullanıcılarının listesi (azalan düzende)
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 tarafından yönetilmiyor.
recentUsers[].email

string

Kullanıcının e-posta adresi. Bu durum yalnızca kullanıcı türü USER_TYPE_MANAGED ise 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 belirtildiği veya kayıt sırasında belirtilen öğe tanımlayıcısı.
etag

string

Kaynağın ETag.
diskVolumeReports[]

object

Disk alanı raporları ve eklenmiş/bağlı birimler hakkında diğer bilgiler.
diskVolumeReports[].volumeInfo[]

object

Disk birimleri
diskVolumeReports[].volumeInfo[].volumeId

string

Birim 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)

Cihazda bayt cinsinden toplam RAM
cpuStatusReports[]

object

CPU kullanımı ve sıcaklığıyla ilgili 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 olarak sıcaklık.
cpuStatusReports[].cpuTemperatureInfo[].label

string

CPU etiketi
cpuInfo[]

object

Cihazın CPU özellikleriyle ilgili bilgiler.
cpuInfo[].model

string

CPU model adı.
cpuInfo[].architecture

string

CPU mimarisi.
cpuInfo[].maxClockSpeedKhz

integer

kHz cinsinden maksimum CPU saat hızı.
cpuInfo[].logicalCpus[]

object

Mantıksal CPU'lar için bilgiler
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.

"s" ile biten ve en fazla dokuz kesir basamağı olan, saniye cinsinden bir süre. Örnek: "3.5s".
cpuInfo[].logicalCpus[].cStates[]

object

C Durumları, CPU'nun güç tüketimi durumunu belirtir. Daha fazla bilgi için CPU maker 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.

"s" ile biten ve en fazla dokuz kesir basamağı olan, saniye cinsinden bir 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 miktar 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

string (int64 format)

(Salt okunur) Cihazın Chrome güncellemelerini veya desteğini almayı durduracağı zaman damgası
ethernetMacAddress0

string

(Salt okunur) Chromebook'un dahili ethernet bağlantı noktası ve yerleşik ağ (ethernet) arayüzü için kullanılan MAC adresi. Biçim, sınırlayıcısız (büyük harf) on iki (12) on altılı basamaktan oluşur. Bu yalnızca bazı cihazlar için geçerlidir.
dockMacAddress

string

(Salt okunur) Cihazın bağlandığı yuva istasyonu için yerleşik MAC adresi. Fabrika ayarı, 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, sınırlayıcısız (büyük harf) on iki (12) on altılı basamaktan oluşur. Bu yalnızca bazı cihazlar için geçerlidir.
manufactureDate

string

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

string

Cihazla ilişkili kuruluş biriminin adını içeren 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 çizgiyle (/) gösterilir. Bu özellik, API kullanılarak güncellenebilir. Cihazınız için kuruluş yapısı oluşturma hakkında 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 stili 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 Spesifikasyona bakın.
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 okunabilir sürümüdür. orgUnitPath, yol içindeki bir kuruluş biriminin yeniden adlandırılmasıyla değişebilir ancak orgUnitId, tek bir kuruluş birimi için değiştirilemez. Bu özellik, API kullanılarak güncellenebilir. Cihazınız için kuruluş yapısı oluşturma hakkında daha fazla bilgi edinmek için yönetim yardım merkezine bakın.
osUpdateStatus

object (OsUpdateStatus)

Cihaz için işletim sistemi güncellemelerinin durumu.
firstEnrollmentTime

string

Cihazın ilk kaydettirildiği tarih ve saat.
lastDeprovisionTimestamp

string

(Salt okunur) Cihazın temel hazırlığının son kaldırılacağı 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.

OsUpdateStatus

Mevcut işletim sistemi 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 OS 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. Bazı uç durumlarda, UPDATE_STATUS_NEED_REBOOT için bunun "0.0.0.0" geçersiz olabileceğini unutmayın. Örneğin, güncelleme motorunun yeniden başlatılmadan yeniden başlatılması.
targetKioskAppVersion

string

Güncellenmeyi bekleyen kiosk uygulamasından alınan gerekli yeni platform sürümü.
updateTime

string

Son başarılı OS güncellemesinin tarih ve saati.
updateCheckTime

string

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

string

Son yeniden başlatma işleminin tarihi ve saati.

UpdateState

Bir OS güncellemesinin güncelleme durumu.

Sıralamalar
UPDATE_STATE_UNSPECIFIED Güncelleme durumu belirtilmedi.
UPDATE_STATE_NOT_STARTED Bekleyen bir güncelleme var, ancak henüz başlatılmadı.
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

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ı garanti kapsamında aynı cihazın yenisiyle değiştiriyorsanız
DEPROVISION_REASON_UPGRADE

Cihazın yükseltmesi yapıldı.
DEPROVISION_REASON_DOMAIN_MOVE

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

Cihazın hizmet 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 yeni bir modelle değiştiriyorsunuz.
DEPROVISION_REASON_RETIRING_DEVICE Envanterden çı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 gerekli değildi. Örneğin, lisanslar müşterinin lisans havuzuna iade edilmiştir.
DEPROVISION_REASON_REPAIR_CENTER Cihazın temel hazırlığı, Onarım Hizmetleri Merkezi tarafından kaldırıldı. Yalnızca RMA sırasında Onarım Hizmetleri Merkezi tarafından ayarlanabilir.

DeviceLicenseType

Bu cihazın lisans türü.

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

BacklightInfo

Cihazın arka ışıkları hakkında bilgi.

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

string

Yalnızca çıkış. Sistemdeki bu arka ışığın yolu. Arayanın diğer bilgilerle bağdaştırması gerekiyorsa kullanışlı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 maxBrightness arasında.

Yöntemler

action
(deprecated)

 Bunun yerine BatchChangeChromeOsDeviceStatus öğesini kullanın.

get

 Bir Chrome OS cihazın özelliklerini alır.

list

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

moveDevicesToOu

 Birden fazla Chrome OS cihazı bir kuruluş birimine taşır veya ekler.

patch

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

update

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