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 ซึ่งใช้ในกระบวนการผลิตและการขาย ใช้ได้กับอุปกรณ์ Chrome OS เท่านั้น
ช่อง Union hardware_id รหัสฮาร์ดแวร์จะอิงตามรหัสโมเด็ม hardware_id ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้
imei

string

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

string

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

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

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

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

ข้อมูลเมตาของอุปกรณ์

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

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

map (key: string, value: string)

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

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

การอ้างสิทธิ์อุปกรณ์

ระเบียนของอุปกรณ์ที่ตัวแทนจําหน่ายอ้างสิทธิ์สําหรับลูกค้า อุปกรณ์ที่มีการอ้างสิทธิ์การตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มมีการอ้างสิทธิ์ประเภท 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 ที่เป็นเจ้าของอุปกรณ์ Chrome OS
additionalService

enum (AdditionalService)

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

ประเภทส่วนการจัดสรรอุปกรณ์

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

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

บริการเพิ่มเติม

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

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

วิธีการ

applyConfiguration

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

get

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

list

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

removeConfiguration

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

unclaim

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