Giá trị nhận dạng

DeviceIdentifier đóng gói các mã phần cứng để xác định thiết bị được sản xuất sẵn. Tài liệu này giải thích cách làm việc với 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 bắt buộc phải có để nhận dạng duy nhất xác định một thiết bị.

Tổ chức của bạn thêm giá trị số nhận dạng thiết bị khi tải 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, bạn không thể sử dụng API để thay đổi 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 IMEI (hoặc MEID) ID modem di động. 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 thiết bị bằng cách sử dụng một nhóm trường khác. Chiến lược phát hành đĩa đơn bảng sau đây trình bày các trường bắt buộc đối với 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. 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 các đố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ị hai 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à giống với giá trị được Build.getSerial() trả về.
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ị mà Build.MODEL trả về. Hãy xem tài liệu tham khảo về 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 với thiết bị chỉ kết nối Wi‐Fi, giá trị của trường manufacturer phải khớp với giá trị tích hợp sẵn của thiết bị mà Build.MANUFACTURER trả về. Đối với thiết bị di động, trường manufacturer là trường không bắt buộc nhưng nên dùng, vì trường này giúp khách hàng dễ dàng xác định thiết bị của họ hơn. 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, ví dụ: máy tính bảng hoặc máy quét kho hàng, sử dụng các trường Chỉ Wi-Fi. Đối với tất cả các thiết bị khác, sử dụng trường di động.

Thiết bị hai SIM

Thiết bị hai SIM bao gồm 2 modem rời và 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 hiệu quả hơn đáng tin cậy với số IMEI thấp nhất.

Thiết bị ChromeOS

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

Số nhận dạng Ghi chú
serialNumber Số sê-ri của nhà sản xuất của thiết bị.
model Giá trị mẫu thiết bị phải khớp với giá trị của thiết bị giá trị tích hợp sẵn. Xem danh sách giá trị mô hình ChromeOS để tham khảo.
chromeOsAttestedDeviceId Mã thiết bị đã được chứng thực. Xem danh sách ChromeOS tương thích thiết bị cho tham chiếu.

Tham khảo 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 cung cấp các trường bắt buộc được chỉ định cho loại thiết bị.

Đoạn mã sau đây cho biết số IMEI dùng để tì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 thiết bị chỉ kết nối Wi-Fi giá trị nhận dạng:

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