ตัวระบุ

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