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

enum (DeviceProvisioningSectionType)

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

ownerCompanyId

string (int64 format)

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

googleWorkspaceCustomerId

string

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

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

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