Giá trị nhận dạng

DeviceIdentifier đóng gói mã nhận dạng phần cứng để xác định một thiết bị được sản xuất. Tài liệu này giải thích cách xử lý các giá trị nhận dạng trong API thiết lập tự động.

DeviceIdentifier kết hợp siêu dữ liệu phần cứng hoặc mã nhận dạng cần thiết để nhận dạng duy nhất một thiết bị.

Tổ chức của bạn đưa vào các giá trị mã 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. Vì các thực thể DeviceIdentifier là không thể thay đổi, nên bạn không thể sử dụng API để thay đổi các giá trị của trường.

Các trường bắt buộc

Thiết bị Android

Quy trình thiết lập tự động thường xác định thiết bị bằng mã modem di động IMEI (hoặc MEID). Tuy nhiên, để 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 trình bày các trường bắt buộc cho từng loại thiết bị:

Giá trị 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. Quy trình thiết lập tự động sẽ xác thực định dạng của các giá trị IMEI khi bạn truyền các giá trị đó vào đối số API. Đối với các thiết bị có nhiều modem di động, hãy xem phần Thiết bị dùng 2 SIM.
serialNumber Số sê-ri của nhà sản xuất thiết bị. Số sê-ri có phân biệt chữ hoa chữ thường và là 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 của thiết bị được trả về từ Build.MODEL. Hãy xem tài liệu tham khảo tên kiểu máy để biết danh sách các giá trị được phép đối với từng nhà sản xuất.
manufacturer Để quy trình thiết lập tự động hoạt động trên thiết bị chỉ có Wi‐Fi, giá trị của trường manufacturer phải khớp với giá trị tích hợp của thiết bị được trả về từ Build.MANUFACTURER. Đối với các thiết bị di động, bạn không bắt buộc phải sử dụng trường manufacturer, vì trường này sẽ giúp khách hàng dễ dàng xác định thiết bị của họ hơn. 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 thiết bị không có modem di động, chẳng hạn như máy quét kho hàng hoặc máy tính bảng, hãy sử dụng các trường chỉ dành cho Wi-Fi. Đối với tất cả các thiết bị khác, hãy sử dụng trường di động.

Thiết bị 2 SIM

Thiết bị hai SIM bao gồm 2 modem riêng biệt và có 2 số IMEI. Sử dụng số IMEI thấp nhất vì quy trình thiết lập tự động hoạt động đáng tin cậy hơn với số IMEI thấp nhất.

Thiết bị ChromeOS

Đối với các thiết bị ChromeOS, bộ giá trị nhận dạng bắt buộc đối với thiết bị di động và thiết bị chỉ có Wi-Fi là giống nhau:

Giá trị nhận dạng Ghi chú
serialNumber Số sê-ri của nhà sản xuất cho thiết bị.
model Giá trị mẫu thiết bị phải khớp với giá trị tích hợp của thiết bị. Hãy xem danh sách giá trị của mô hình ChromeOS để tham khảo.
chromeOsAttestedDeviceId Mã thiết bị đã được chứng thực. Hãy xem danh sách các 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ị chỉ dành cho 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'}

Tìm hiểu thêm