ตัวระบุ

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

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

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

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

อุปกรณ์ Android

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

ตัวระบุ เครือข่ายมือถือ Wi-Fi เท่านั้น หมายเหตุ
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 เท่านั้น:

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

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