REST Resource: chromeosdevices

แหล่งข้อมูล: ChromeOsDevice

อุปกรณ์ Google Chrome ทำงานบน ChromeOS ดูข้อมูลเพิ่มเติมเกี่ยวกับงาน 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)
    }
  ],
  "autoUpdateThrough": string,
  "extendedSupportEligible": boolean,
  "extendedSupportStart": string,
  "extendedSupportEnabled": boolean,
  "fanInfo": [
    {
      object (FanInfo)
    }
  ],
  "chromeOsType": enum (ChromeOsType),
  "diskSpaceUsage": {
    object (ByteUsage)
  },
  "osVersionCompliance": enum (Compliance)
}
ช่อง
deviceId

string

รหัสที่ไม่ซ้ำกันของอุปกรณ์ Chrome
serialNumber

string

หมายเลขซีเรียลของอุปกรณ์ Chrome ที่ป้อนเมื่อเปิดใช้อุปกรณ์ ค่านี้จะเหมือนกับหมายเลขซีเรียลของคอนโซลผู้ดูแลระบบในแท็บอุปกรณ์ ChromeOS
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 ของเมธอด list ความยาวสูงสุด 500 อักขระ อนุญาตค่าว่าง
model

string

ข้อมูลรุ่นของอุปกรณ์ หากอุปกรณ์ไม่มีข้อมูลนี้ ระบบจะไม่รวมพร็อพเพอร์ตี้นี้ไว้ในการตอบกลับ
meid

string

Mobile Equipment Identifier (MEID) หรือ International Mobile Equipment Identity (IMEI) สำหรับการ์ดมือถือ 3G ในอุปกรณ์เคลื่อนที่ โดยทั่วไปแล้ว MEID/IMEI จะใช้เมื่อเพิ่มอุปกรณ์ในแพ็กเกจบริการแบบชำระภายหลังของผู้ให้บริการเครือข่ายมือถือ หากอุปกรณ์ไม่มีข้อมูลนี้ ระบบจะไม่รวมพร็อพเพอร์ตี้นี้ไว้ในการตอบกลับ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีส่งออกรายการ MEID/IMEI ได้ที่คู่มือสำหรับนักพัฒนาซอฟต์แวร์
orderNumber

string

หมายเลขคำสั่งซื้อของอุปกรณ์ เฉพาะอุปกรณ์ที่ซื้อจาก Google โดยตรงเท่านั้นที่มีหมายเลขคำสั่งซื้อ
willAutoRenew

boolean

กำหนดว่าอุปกรณ์จะต่ออายุการสนับสนุนโดยอัตโนมัติหลังจากวันที่สิ้นสุดการสนับสนุนหรือไม่ พร็อพเพอร์ตี้นี้เป็นแบบอ่านอย่างเดียว
osVersion

string

เวอร์ชันระบบปฏิบัติการของอุปกรณ์ Chrome
platformVersion

string

เวอร์ชันแพลตฟอร์มของอุปกรณ์ Chrome
firmwareVersion

string

เวอร์ชันเฟิร์มแวร์ของอุปกรณ์ Chrome
macAddress

string

ที่อยู่ MAC แบบไร้สายของอุปกรณ์ หากอุปกรณ์ไม่มีข้อมูลนี้ ระบบจะไม่รวมข้อมูลดังกล่าวไว้ในการตอบกลับ
bootMode

string

โหมดการเริ่มต้นระบบสำหรับอุปกรณ์ ค่าที่เป็นไปได้มีดังนี้

  • Verified: อุปกรณ์ใช้ ChromeOS เวอร์ชันที่ถูกต้อง
  • 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 (