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.

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

string

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

string

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

string

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

enum (DeviceType)

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

string

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

string

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

string

หมายเลข MEID ของอุปกรณ์
ฟิลด์สหภาพ hardware_id2 รหัสฮาร์ดแวร์อันที่ 2 สำหรับอุปกรณ์แบบ 2 ซิม หากตั้งค่าไว้ ต้องเป็นประเภทตัวระบุเดียวกับรหัสฮาร์ดแวร์แรก hardware_id2 ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
imei2

string

หมายเลข IMEI ที่ 2 ของอุปกรณ์
meid2

string

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

DeviceType

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

Enum
DEVICE_TYPE_ANDROID อุปกรณ์ Android
DEVICE_TYPE_CHROME_OS อุปกรณ์ Chrome OS

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)

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

string

รหัสของบัญชี Google Workspace ที่เป็นเจ้าของอุปกรณ์ Chrome OS
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

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