DeviceIdentifier
สรุปรหัสฮาร์ดแวร์เพื่อระบุอุปกรณ์ที่ผลิต เอกสารนี้จะอธิบายวิธีทำงานกับตัวระบุใน API การตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม
DeviceIdentifier
จะรวมข้อมูลเมตาหรือรหัสของฮาร์ดแวร์ที่ต้องใช้ในการระบุอุปกรณ์โดยไม่ซ้ำกัน
องค์กรของคุณมีค่าตัวระบุอุปกรณ์เมื่ออัปโหลดข้อมูลอุปกรณ์ผ่านพอร์ทัลหรือเรียกใช้ API เนื่องจากอินสแตนซ์ DeviceIdentifier
จะเปลี่ยนแปลงไม่ได้ คุณจึงใช้ API เพื่อเปลี่ยนค่าของช่องไม่ได้
ฟิลด์ที่จำเป็น
อุปกรณ์ Android
การตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มมักจะระบุอุปกรณ์ด้วยรหัสโมเด็มเครือข่ายมือถือของ IMEI (หรือ MEID) แต่หากต้องการรองรับอุปกรณ์ที่ไม่มีโมเด็มเครือข่ายมือถือ เช่น แท็บเล็ต คุณจะระบุอุปกรณ์โดยใช้ช่องต่างๆ ได้ด้วย ตารางต่อไปนี้แสดงช่องที่ต้องระบุสำหรับอุปกรณ์แต่ละประเภท
ตัวระบุ | เครือข่ายมือถือ | Wi-Fi เท่านั้น | Notes |
---|---|---|---|
hardware_id |
ฟิลด์นี้ต้องเป็นหมายเลข IMEI หรือ MEID การตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มจะตรวจสอบรูปแบบของค่า IMEI เมื่อคุณส่งผ่านค่าในอาร์กิวเมนต์ API สำหรับอุปกรณ์ที่มีโมเด็มเครือข่ายมือถือมากกว่า 1 เครื่อง โปรดดูอุปกรณ์แบบ 2 ซิม | ||
serialNumber |
หมายเลขซีเรียลของอุปกรณ์ของผู้ผลิต หมายเลขซีเรียลจะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ และเป็นค่าเดียวกับที่ส่งกลับมาจาก Build.getSerial() |
||
model |
ค่ารุ่นอุปกรณ์ต้องตรงกับค่าในตัวของอุปกรณ์ที่ส่งคืนจาก Build.MODEL ดูข้อมูลอ้างอิงชื่อรุ่นสำหรับรายการค่าที่อนุญาตสำหรับผู้ผลิตแต่ละราย |
||
manufacturer |
ค่าในช่อง manufacturer ต้องตรงกับค่าในตัวของอุปกรณ์ที่ส่งคืนจาก Build.MANUFACTURER เพื่อให้การตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มทำงานในอุปกรณ์ที่มี Wi-Fi เท่านั้น สำหรับอุปกรณ์เคลื่อนที่ เราขอแนะนำให้ใช้ช่อง manufacturer หรือไม่ก็ได้ เนื่องจากจะช่วยให้ลูกค้าระบุอุปกรณ์ได้ง่าย ดูข้อมูลเพิ่มเติมในข้อมูลอ้างอิงชื่อผู้ผลิต |
หากอุปกรณ์ไม่มีโมเด็มเครือข่ายมือถือ เช่น แท็บเล็ตหรือเครื่องสแกนคลังสินค้า ให้ใช้ช่อง Wi-Fi เท่านั้น สำหรับอุปกรณ์อื่นๆ ทั้งหมด ให้ใช้ช่องเครือข่ายมือถือ
อุปกรณ์แบบ 2 ซิม
อุปกรณ์แบบ 2 ซิมประกอบด้วยโมเด็ม 2 ตัว และมีหมายเลข IMEI 2 หมายเลข ใช้หมายเลข IMEI ที่ต่ำที่สุด เนื่องจากการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มจะทํางานได้อย่างน่าเชื่อถือมากกว่าเมื่อใช้ IMEI ที่ต่ำที่สุด
อุปกรณ์ ChromeOS
สำหรับอุปกรณ์ ChromeOS ชุดตัวระบุที่จำเป็นจะเหมือนกันสำหรับอุปกรณ์เคลื่อนที่และอุปกรณ์ที่มี Wi-Fi เท่านั้น
ตัวระบุ | Notes |
---|---|
serialNumber
|
หมายเลขซีเรียลของอุปกรณ์ ของผู้ผลิต |
model
|
ค่ารุ่นอุปกรณ์ต้องตรงกับค่าในตัวของอุปกรณ์ ดูรายการค่าโมเดล ChromeOS เพื่อเป็นข้อมูลอ้างอิง |
chromeOsAttestedDeviceId
|
รหัสอุปกรณ์ที่ผ่านการรับรอง ดูรายชื่ออุปกรณ์ ChromeOS ที่เข้ากันได้เพื่อเป็นข้อมูลอ้างอิง |
อ้างอิงอุปกรณ์
ใช้ DeviceIdentifier
เมื่อค้นหาหรืออ้างสิทธิ์อุปกรณ์ คุณต้องใส่ช่องที่ต้องกรอกที่ระบุสำหรับประเภทอุปกรณ์
ข้อมูลโค้ดต่อไปนี้แสดงหมายเลข IMEI ที่ใช้ค้นหาอุปกรณ์ที่เจาะจงด้วยการโทรหา partners.devices.findByIdentifier
Java
// Create a DeviceIdentifier. DeviceIdentifier deviceIdentifier = new DeviceIdentifier(); deviceIdentifier.setImei("123456789012347"); // Perform the search using the zero-touch enrollment API. FindDevicesByDeviceIdentifierRequest body = new FindDevicesByDeviceIdentifierRequest(); body.setLimit(1L); body.setDeviceIdentifier(deviceIdentifier); FindDevicesByDeviceIdentifierResponse response = service .partners() .devices() .findByIdentifier(PARTNER_ID, body) .execute();
.NET
// Create a DeviceIdentifier. var deviceIdentifier = new DeviceIdentifier { Imei = "123456789012347" }; // Perform the search using the zero-touch enrollment API. var body = new FindDevicesByDeviceIdentifierRequest { Limit = 1, DeviceIdentifier = deviceIdentifier }; var response = service.Partners.Devices.FindByIdentifier(body, PartnerId).Execute();
Python
# Create a DeviceIdentifier. device_identifier = {'imei':'123456789012347'} # Perform the search using the zero-touch enrollment API. response = service.partners().devices().findByIdentifier( partnerId=PARTNER_ID, body={'deviceIdentifier':device_identifier, \ 'limit':1}).execute()
ข้อมูลโค้ดต่อไปนี้แสดงวิธีสร้างตัวระบุอุปกรณ์แบบ Wi-Fi เท่านั้น
Java
// Create a device identifier to find a Wi-Fi-only device. DeviceIdentifier deviceIdentifier = new DeviceIdentifier(); deviceIdentifier.setManufacturer("Honeywell"); deviceIdentifier.setModel("VM1A"); deviceIdentifier.setSerialNumber("ABcd1235678");
.NET
// Create a device identifier to find a Wi-Fi-only device. var deviceIdentifier = new DeviceIdentifier { Manufacturer = "Honeywell", Model = "VM1A", SerialNumber = "ABcd1235678" };
Python
# Create a device identifier to find a Wi-Fi-only device. device_identifier = {'manufacturer':'Honeywell', \ 'model':'VM1A', 'serialNumber':'ABcd1235678'}
ดูข้อมูลเพิ่มเติม
- ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวระบุฮาร์ดแวร์ได้ที่เอกสารอ้างอิง API สำหรับ
DeviceIdentifier
- หากต้องการดูรายการชื่อผู้ผลิตและรุ่นของอุปกรณ์ที่อนุญาต โปรดอ่านข้อมูลอ้างอิงชื่อผู้ผลิต
- หากต้องการดูรายการอุปกรณ์ ChromeOS ที่เข้ากันได้ โปรดไปที่ศูนย์ช่วยเหลือของ ChromeOS