Method: partners.devices.findByIdentifier
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tìm thiết bị theo mã nhận dạng phần cứng, chẳng hạn như IMEI.
Yêu cầu HTTP
POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:findByIdentifier
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Tham số |
partnerId |
string (int64 format)
Bắt buộc. Mã của đối tác đại lý.
|
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
| Biểu diễn dưới dạng JSON |
{
"pageToken": string,
"limit": string,
"deviceIdentifier": {
object (DeviceIdentifier)
}
} |
| Trường |
pageToken |
string
Mã thông báo chỉ định trang kết quả nào cần trả về.
|
limit |
string (int64 format)
Bắt buộc. Số lượng thiết bị tối đa có thể xuất hiện trên một trang kết quả. Giá trị phải nằm trong khoảng từ 1 đến 100.
|
deviceIdentifier |
object (DeviceIdentifier)
Bắt buộc. Bắt buộc. Mã nhận dạng thiết bị cần tìm kiếm.
|
Nội dung phản hồi
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Câu trả lời chứa các thiết bị tìm thấy.
| Biểu diễn dưới dạng JSON |
{
"devices": [
{
object (Device)
}
],
"nextPageToken": string,
"totalSize": integer
} |
| Trường |
devices[] |
object (Device)
Đã tìm thấy thiết bị.
|
nextPageToken |
string
Mã thông báo dùng để truy cập vào trang kết quả tiếp theo. Bị bỏ qua nếu không có thêm kết quả.
|
totalSize |
integer
Tổng số mục trong danh sách, bất kể việc phân trang.
|
Phạm vi cấp phép
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/androidworkprovisioning
Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\u003cp\u003eThis API endpoint allows searching for devices by hardware identifiers like IMEI using a POST request.\u003c/p\u003e\n"],["\u003cp\u003eThe request URL follows gRPC Transcoding syntax and requires the \u003ccode\u003epartnerId\u003c/code\u003e as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must include \u003ccode\u003epageToken\u003c/code\u003e, \u003ccode\u003elimit\u003c/code\u003e, and \u003ccode\u003edeviceIdentifier\u003c/code\u003e to specify the search criteria and results page size.\u003c/p\u003e\n"],["\u003cp\u003eThe response body includes a list of \u003ccode\u003edevices\u003c/code\u003e, along with \u003ccode\u003enextPageToken\u003c/code\u003e for pagination and \u003ccode\u003etotalSize\u003c/code\u003e for the total device count.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for this API requires the OAuth scope \u003ccode\u003ehttps://www.googleapis.com/auth/androidworkprovisioning\u003c/code\u003e.\u003c/p\u003e\n"]]],["This content describes how to find devices by hardware identifiers using a POST request to `https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:findByIdentifier`. The request requires a `partnerId` path parameter. The request body must include `pageToken`, `limit` (1-100), and `deviceIdentifier`. The response body includes an array of `devices`, `nextPageToken` for pagination, and `totalSize`. This operation requires the `https://www.googleapis.com/auth/androidworkprovisioning` OAuth scope.\n"],null,["# Method: partners.devices.findByIdentifier\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.FindDevicesByDeviceIdentifierResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n\nFinds devices by hardware identifiers, such as IMEI.\n\n### HTTP request\n\n`POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:findByIdentifier`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-------------|-------------------------------------------------------------------------------------------------------------------------------|\n| `partnerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the reseller partner. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation ||\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"pageToken\": string, \"limit\": string, \"deviceIdentifier\": { object (/zero-touch/reference/reseller/rest/v1/partners.devices#DeviceIdentifier) } } ``` |\n\n| Fields ||\n|--------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageToken` | `string` A token specifying which result page to return. |\n| `limit` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The maximum number of devices to show in a page of results. Must be between 1 and 100 inclusive. |\n| `deviceIdentifier` | `object (`[DeviceIdentifier](/zero-touch/reference/reseller/rest/v1/partners.devices#DeviceIdentifier)`)` Required. Required. The device identifier to search for. |\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\nResponse containing found devices.\n\n| JSON representation ||\n|-------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"devices\": [ { object (/zero-touch/reference/reseller/rest/v1/partners.devices#Device) } ], \"nextPageToken\": string, \"totalSize\": integer } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------------------------------------------------|\n| `devices[]` | `object (`[Device](/zero-touch/reference/reseller/rest/v1/partners.devices#Device)`)` Found devices. |\n| `nextPageToken` | `string` A token used to access the next page of results. Omitted if no further results are available. |\n| `totalSize` | `integer` The total count of items in the list irrespective of pagination. |\n\n### Authorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidworkprovisioning`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
