DeviceIdentifier
đóng gói mã nhận dạng phần cứng để xác định một thiết bị đã sản xuất. Tài liệu này giải thích cách xử lý giá trị nhận dạng trong API đăng ký không tiếp xúc.
DeviceIdentifier
kết hợp siêu dữ liệu hoặc mã nhận dạng phần cứng cần thiết để xác định duy nhất một thiết bị.
Tổ chức của bạn sẽ thêm các giá trị giá trị nhận dạng thiết bị khi tải dữ liệu thiết bị lên thông qua cổng thông tin hoặc gọi API.
Các trường bắt buộc
Thiết bị Android
Quy trình đăng ký không tiếp xúc thường xác định thiết bị theo mã nhận dạng modem di động IMEI (hoặc MEID). Để hỗ trợ các thiết bị không có modem di động, chẳng hạn như máy tính bảng, bạn cũng có thể xác định các thiết bị bằng một nhóm trường khác. Bảng sau đây cho biết các trường mà bạn có thể sử dụng cho từng loại thiết bị:
Số nhận dạng | Mạng di động | Chỉ Wi-Fi | Ghi chú |
---|---|---|---|
hardware_id |
Trường này phải là số IMEI hoặc MEID. Tính năng đăng ký không tiếp xúc xác thực định dạng của các giá trị IMEI khi bạn truyền các giá trị đó trong đối số API. | ||
hardware_id2 |
Trường này phải là số IMEI hoặc MEID thứ hai. Tính năng đăng ký không tiếp xúc xác thực định dạng của các giá trị IMEI khi bạn truyền các giá trị đó trong đối số API. Để biết thông tin về các thiết bị có nhiều modem di động, hãy xem phần Thiết bị Dual-SIM. | ||
serialNumber |
Số sê-ri của nhà sản xuất cho thiết bị. Số sê-ri có phân biệt chữ hoa chữ thường và giống với giá trị được trả về từ Build.getSerial() . |
||
model |
Giá trị mẫu thiết bị phải khớp với giá trị tích hợp sẵn của thiết bị được trả về từ Build.MODEL . Hãy xem tài liệu tham khảo về tên mẫu để biết danh sách các giá trị được phép cho từng nhà sản xuất. |
||
manufacturer |
Giá trị trường manufacturer phải khớp với giá trị tích hợp sẵn của thiết bị được trả về từ Build.MANUFACTURER . Hãy xem tài liệu tham khảo về tên nhà sản xuất để biết thêm thông tin. |
Nếu đăng ký số sê-ri, bạn cũng phải đăng ký nhà sản xuất và kiểu máy để đảm bảo tính năng thiết lập tự động có thể phát hiện thiết bị.
Thiết bị hai SIM
Thiết bị SIM kép bao gồm hai modem riêng biệt và có hai số IMEI. Nếu chỉ đăng ký một IMEI, hãy ưu tiên số IMEI thấp nhất vì tính năng đăng ký không tiếp xúc hoạt động đáng tin cậy hơn với IMEI thấp nhất. Để tăng độ tin cậy, bạn có thể đăng ký thêm số IMEI khác hoặc số sê-ri, nhà sản xuất và kiểu máy.
Cách hiển thị IMEI thứ hai trong cổng thông tin tự động:
- Chuyển đến thẻ Thiết bị.
- Ở góc trên bên phải, bên cạnh nút Thêm thiết bị, hãy nhấp vào biểu tượng ba dấu chấm .
- Chọn Tuỳ chỉnh bảng.
- Chọn hộp đánh dấu IMEI2.
- Nhấp vào Lưu.
Thiết bị ChromeOS
Đối với thiết bị ChromeOS, tập hợp giá trị nhận dạng bắt buộc giống nhau đối với thiết bị chỉ có mạng di động và thiết bị chỉ có Wi-Fi:
Số nhận dạng | Ghi chú |
---|---|
serialNumber
|
Số sê-ri của nhà sản xuất cho thiết bị. |
model
|
Giá trị kiểu thiết bị phải khớp với giá trị tích hợp sẵn của thiết bị. Hãy xem danh sách giá trị mô hình ChromeOS để tham khảo. |
chromeOsAttestedDeviceId
|
Mã thiết bị đã được chứng thực. Hãy xem danh sách thiết bị ChromeOS tương thích để tham khảo. |
Tham chiếu đến một thiết bị
Sử dụng DeviceIdentifier
khi tìm hoặc xác nhận quyền sở hữu thiết bị. Bạn cần thêm các trường bắt buộc được chỉ định cho loại thiết bị.
Đoạn mã sau đây cho thấy một số IMEI dùng để tìm kiếm một thiết bị cụ thể bằng cách gọi 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()
Đoạn mã sau đây cho biết cách tạo giá trị nhận dạng thiết bị bằng số sê-ri:
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'}
Tìm hiểu thêm
- Để tìm hiểu thêm về giá trị nhận dạng phần cứng, hãy xem tài liệu tham khảo API cho
DeviceIdentifier
. - Để xem danh sách tên nhà sản xuất và mẫu thiết bị được phép, hãy tham khảo nội dung tham khảo về tên nhà sản xuất.
- Để xem danh sách các thiết bị ChromeOS tương thích, hãy xem Trung tâm trợ giúp ChromeOS