REST Resource: partners.devices

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

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

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

string (int64 format)

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

object (DeviceIdentifier)

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

string

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

object (DeviceMetadata)

ข้อมูลเมตาที่แนบอยู่กับอุปกรณ์ มีโครงสร้างเป็นคู่คีย์-ค่า โปรดดูข้อมูลเพิ่มเติมที่หัวข้อข้อมูลเมตาของอุปกรณ์
claims[]

object (DeviceClaim)

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

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,
  "resellerId": string,
  "additionalService": enum (AdditionalService)
}
ช่อง
sectionType

enum (DeviceProvisioningSectionType)

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

string (int64 format)

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

string

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

string (int64 format)

รหัสของตัวแทนจำหน่ายที่อ้างสิทธิ์อุปกรณ์
additionalService

enum (AdditionalService)

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

DeviceProvisioningSectionType

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

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

AdditionalService

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

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

เมธอด

claim

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

claimAsync

 อ้างสิทธิ์อุปกรณ์ชุดหนึ่งให้ลูกค้าไม่พร้อมกัน

findByIdentifier

 ค้นหาอุปกรณ์ตามตัวระบุฮาร์ดแวร์ เช่น IMEI

findByOwner

 ค้นหาอุปกรณ์ที่อ้างสิทธิ์สำหรับลูกค้า

get

 รับอุปกรณ์

metadata

 อัปเดตข้อมูลเมตาของผู้ค้าปลีกที่เชื่อมโยงกับอุปกรณ์

unclaim

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

unclaimAsync

 ยกเลิกการอ้างสิทธิ์อุปกรณ์หลายเครื่องของลูกค้าแบบไม่พร้อมกัน

updateMetadataAsync

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