REST Resource: customers.devices

ทรัพยากร: อุปกรณ์

อุปกรณ์ Android หรือ Chrome OS ที่ลงทะเบียนในการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม

การแสดง JSON
{
  "deviceId": string,
  "deviceIdentifier": {
    object (DeviceIdentifier)
  },
  "name": string,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "claims": [
    {
      object (DeviceClaim)
    }
  ],
  "configuration": string
}
ช่อง
deviceId

string (int64 format)

เอาต์พุตเท่านั้น รหัสของอุปกรณ์ เซิร์ฟเวอร์เป็นผู้กำหนด

deviceIdentifier

object (DeviceIdentifier)

รหัสฮาร์ดแวร์ที่ระบุอุปกรณ์ที่ผลิต โปรดดูข้อมูลเพิ่มเติมที่หัวข้อตัวระบุ

name

string

เอาต์พุตเท่านั้น ชื่อทรัพยากร API ในรูปแบบ customers/[CUSTOMER_ID]/devices/[DEVICE_ID] เซิร์ฟเวอร์เป็นผู้กำหนด

deviceMetadata

object (DeviceMetadata)

ข้อมูลเมตาที่แนบมากับอุปกรณ์ มีโครงสร้างเป็นคู่คีย์-ค่า

claims[]

object (DeviceClaim)

เอาต์พุตเท่านั้น การอ้างสิทธิ์การจัดสรรสำหรับอุปกรณ์ อุปกรณ์ที่มีการอ้างสิทธิ์การตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มมีการอ้างสิทธิ์ประเภท SECTION_TYPE_ZERO_TOUCH โทรหา customers.devices.unclaim เพื่อนำอุปกรณ์ออกจากการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม

configuration

string

การกำหนดค่าที่ใช้กับอุปกรณ์ในรูปแบบ customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID] ค่าจะเป็น null หากอุปกรณ์ไม่มีการใช้การกำหนดค่า

DeviceIdentifier

ห่อหุ้มฮาร์ดแวร์และรหัสผลิตภัณฑ์เพื่อระบุอุปกรณ์ที่ผลิต โปรดอ่านตัวระบุเพื่อทำความเข้าใจข้อกำหนดสำหรับชุดตัวระบุ

การแสดง JSON
{
  "serialNumber": string,
  "manufacturer": string,
  "model": string,
  "deviceType": enum (DeviceType),
  "chromeOsAttestedDeviceId": string,

  // Union field hardware_id can be only one of the following:
  "imei": string,
  "meid": string
  // End of list of possible types for union field hardware_id.
}
ช่อง
serialNumber

string

หมายเลขซีเรียลของผู้ผลิตสำหรับอุปกรณ์ ค่านี้อาจไม่ซ้ำกันในอุปกรณ์รุ่นต่างๆ

manufacturer

string

ชื่อผู้ผลิตอุปกรณ์ ตรงกับค่าในตัวของอุปกรณ์ที่แสดงผลจาก android.os.Build.MANUFACTURER ค่าที่อนุญาตแสดงอยู่ในผู้ผลิต Android

model

string

ชื่อรุ่นอุปกรณ์ ค่าที่อนุญาตจะแสดงอยู่ในรุ่น Android และรุ่น Chrome OS

deviceType

enum (DeviceType)

ประเภทอุปกรณ์

chromeOsAttestedDeviceId

string

ตัวระบุที่ OEM มอบให้ซึ่งส่งผ่านกระบวนการผลิตและการขาย ใช้ได้กับอุปกรณ์ ChromeOS เท่านั้น

ฟิลด์การรวม hardware_id รหัสฮาร์ดแวร์ตามรหัสโมเด็ม hardware_id ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
imei

string

หมายเลข IMEI ของอุปกรณ์ ตรวจสอบอินพุตแล้ว

meid

string

หมายเลข MEID ของอุปกรณ์

DeviceType

ระบบปฏิบัติการของอุปกรณ์

Enum
DEVICE_TYPE_ANDROID อุปกรณ์ Android
DEVICE_TYPE_CHROME_OS อุปกรณ์ ChromeOS

DeviceMetadata

รายการข้อมูลเมตาที่แนบกับ Device ได้ โปรดดูข้อมูลเพิ่มเติมที่หัวข้อข้อมูลเมตาของอุปกรณ์

การแสดง JSON
{
  "entries": {
    string: string,
    ...
  }
}
ช่อง
entries

map (key: string, value: string)

บันทึกรายการข้อมูลเมตาเป็นคู่คีย์-ค่า

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่างเช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }

DeviceClaim

บันทึกของอุปกรณ์ที่ตัวแทนจำหน่ายอ้างสิทธิ์สำหรับลูกค้า อุปกรณ์ที่มีการอ้างสิทธิ์การตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มมีการอ้างสิทธิ์ประเภท SECTION_TYPE_ZERO_TOUCH โปรดดูข้อมูลเพิ่มเติมที่หัวข้ออ้างสิทธิ์อุปกรณ์ให้กับลูกค้า

การแสดง JSON
{
  "sectionType": enum (DeviceProvisioningSectionType),
  "ownerCompanyId": string,
  "googleWorkspaceCustomerId": string,
  "additionalService": enum (AdditionalService)
}
ช่อง
sectionType

enum (DeviceProvisioningSectionType)

เอาต์พุตเท่านั้น ประเภทของการอ้างสิทธิ์ในอุปกรณ์

ownerCompanyId

string (int64 format)

รหัสของลูกค้าที่ซื้ออุปกรณ์ Android

googleWorkspaceCustomerId

string

รหัสบัญชี Google Workspace ที่เป็นเจ้าของอุปกรณ์ ChromeOS

additionalService

enum (AdditionalService)

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

DeviceProvisioningSectionType

ประเภทส่วนของระเบียนการจัดสรร

Enum
SECTION_TYPE_SIM_LOCK ประเภทส่วนการล็อกซิม
SECTION_TYPE_ZERO_TOUCH ประเภทส่วนการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม

AdditionalService

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

Enum
DEVICE_PROTECTION บริการปกป้องอุปกรณ์ หรือที่เรียกว่า Android Enterprise Essentials หากต้องการอ้างสิทธิ์อุปกรณ์ที่มีบริการคุ้มครองอุปกรณ์ คุณต้องลงทะเบียนกับทีมพาร์ทเนอร์

เมธอด

applyConfiguration

ใช้การกำหนดค่ากับอุปกรณ์เพื่อลงทะเบียนอุปกรณ์สำหรับการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม

get

ดูรายละเอียดของอุปกรณ์

list

แสดงรายการอุปกรณ์ของลูกค้า

removeConfiguration

นำการกำหนดค่าออกจากอุปกรณ์

unclaim

ถอนการอ้างสิทธิ์อุปกรณ์จากลูกค้าและนำออกจากการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม