รหัสระบุ

DeviceIdentifier จะเป็นแพ็กเกจรหัสฮาร์ดแวร์เพื่อระบุอุปกรณ์ที่ผลิต เอกสารนี้อธิบายวิธีใช้ตัวระบุใน API การลงทะเบียนแบบรวมศูนย์

DeviceIdentifier รวมข้อมูลเมตาหรือรหัสฮาร์ดแวร์ที่จําเป็นสําหรับการระบุอุปกรณ์โดยไม่ซ้ำกัน

องค์กรของคุณจะใส่ค่าตัวระบุอุปกรณ์เมื่ออัปโหลดข้อมูลอุปกรณ์ผ่านพอร์ทัลหรือเรียกใช้ API

ฟิลด์ที่จำเป็น

อุปกรณ์ Android

โดยปกติแล้วการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มจะระบุอุปกรณ์ตามรหัส IMEI (หรือ MEID) ของโมเด็มมือถือ หากต้องการรองรับอุปกรณ์ที่ไม่มีโมเด็มเครือข่ายมือถือ เช่น แท็บเล็ต คุณยังระบุอุปกรณ์ได้โดยใช้ช่องชุดอื่น ตารางต่อไปนี้แสดงช่องที่คุณใช้กับอุปกรณ์แต่ละประเภทได้

ตัวระบุ เครือข่ายมือถือ Wi-Fi เท่านั้น หมายเหตุ
hardware_id ช่องนี้ต้องเป็นหมายเลข IMEI หรือ MEID ลงทะเบียนแบบรวมศูนย์จะตรวจสอบรูปแบบของค่า IMEI เมื่อคุณส่งค่าเหล่านั้นในอาร์กิวเมนต์ API
hardware_id2 ช่องนี้ต้องเป็นหมายเลข IMEI หรือ MEID หมายเลขที่ 2 ลงทะเบียนแบบรวมศูนย์จะตรวจสอบรูปแบบของค่า IMEI เมื่อคุณส่งค่าเหล่านั้นในอาร์กิวเมนต์ API ดูข้อมูลเกี่ยวกับอุปกรณ์ที่มีโมเด็มมือถือมากกว่า 1 ตัวได้ที่อุปกรณ์แบบ 2 ซิม
serialNumber หมายเลขซีเรียลของอุปกรณ์จากผู้ผลิต หมายเลขซีเรียลจะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ และเป็นค่าเดียวกับที่แสดงผลจาก Build.getSerial()
model ค่ารุ่นอุปกรณ์ต้องตรงกับค่าในตัวของอุปกรณ์ที่แสดงผลจาก Build.MODEL ดูรายการค่าที่อนุญาตสำหรับผู้ผลิตแต่ละรายได้ที่ข้อมูลอ้างอิงชื่อรุ่น
manufacturer ค่าในช่อง manufacturer ต้องตรงกับค่าในตัวของอุปกรณ์ที่แสดงผลจาก Build.MANUFACTURER ดูข้อมูลเพิ่มเติมได้ที่ข้อมูลอ้างอิงชื่อผู้ผลิต

หากลงทะเบียนหมายเลขซีเรียล คุณต้องลงทะเบียนผู้ผลิตและรุ่นด้วยเพื่อให้การตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มตรวจพบอุปกรณ์ได้

อุปกรณ์แบบ 2 ซิม

อุปกรณ์แบบ 2 ซิมประกอบด้วยโมเด็ม 2 ตัว และมีหมายเลข IMEI 2 หมายเลข หากลงทะเบียน IMEI เพียงหมายเลขเดียว ให้เลือกหมายเลข IMEI ที่ต่ำที่สุด เนื่องจากการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มจะทำงานได้อย่างน่าเชื่อถือมากขึ้นเมื่อใช้ IMEI ที่ต่ำที่สุด หากต้องการเพิ่มความน่าเชื่อถือ คุณสามารถลงทะเบียน IMEI หรือหมายเลขซีเรียล ผู้ผลิต และรุ่นอื่นๆ เพิ่มเติมได้

วิธีแสดง IMEI หมายเลขที่ 2 ในพอร์ทัลการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม

  1. ไปที่แท็บอุปกรณ์
  2. คลิกจุด 3 จุด ที่มุมขวาบนข้างปุ่มเพิ่มอุปกรณ์
  3. เลือกปรับแต่งตาราง
  4. เลือกช่องทําเครื่องหมายสําหรับ IMEI2
  5. คลิกบันทึก

อุปกรณ์ ChromeOS

สำหรับอุปกรณ์ ChromeOS ชุดตัวระบุที่จำเป็นจะเหมือนกันสำหรับอุปกรณ์ที่ใช้เครือข่ายมือถือและ Wi-Fi เท่านั้น ดังนี้

ตัวระบุ หมายเหตุ
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()

ตัวอย่างข้อมูลต่อไปนี้แสดงวิธีสร้างตัวระบุอุปกรณ์ด้วยหมายเลขซีเรียล

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'}

ดูข้อมูลเพิ่มเติม