findDevicesByOwner
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.
Liệt kê các thiết bị do khách hàng đã chỉ định hoặc khách hàng mua.
Chữ ký phương thức
public FindDevicesResponse findDevicesByOwner(FindDevicesByOwnerRequest request) throws CommonException;
FindDevicesByOwnerRequest
| Tên tài sản |
Giá trị |
Bắt buộc |
Mô tả |
customers |
object(CompanyReference) |
Có |
Danh sách tối đa 100 khách hàng. |
pageSize |
int |
Không |
Kích thước trang, tối đa là 100. Nếu giá trị lớn hơn 100 hoặc null, thì 100 sẽ được dùng. |
pageToken |
string |
Không |
Mã thông báo trang. Nếu trống, trang đầu tiên sẽ được trả về. |
vendorParams |
map |
Không |
Các trường bổ sung, cặp khoá-giá trị do nhà cung cấp chỉ định. |
FindDevicesResponse
| Tên tài sản |
Giá trị |
Mô tả |
devices |
object(Device) |
Danh sách thiết bị do đại lý tải lên. Để trống nếu không có kết quả trùng khớp. |
totalCount |
int |
Tổng số thiết bị khớp với yêu cầu. |
nextPageToken |
strong |
Mã thông báo trang tiếp theo. Trống đối với trang cuối cùng. |
vendorParams |
map |
Không bắt buộc. Các trường bổ sung, cặp khoá-giá trị do nhà cung cấp chỉ định. |
Cách hoạt động của lỗi
Nếu xảy ra lỗi, thư viện sẽ gửi một CommonException chứa một trong các mã lỗi sau:
| Mã lỗi |
AUTHORIZATION_FAILED |
INTERNAL_SERVER_ERROR |
INVALID_PAGE_TOKEN |
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-08-29 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-29 UTC."],[[["\u003cp\u003eThis API method \u003ccode\u003efindDevicesByOwner\u003c/code\u003e retrieves a list of devices associated with specified customers.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires a list of up to 100 \u003ccode\u003ecustomers\u003c/code\u003e (CompanyReference objects), and supports pagination via \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of \u003ccode\u003edevices\u003c/code\u003e, the \u003ccode\u003etotalCount\u003c/code\u003e of matching devices, and a \u003ccode\u003enextPageToken\u003c/code\u003e for subsequent pages.\u003c/p\u003e\n"],["\u003cp\u003eOptional parameters such as \u003ccode\u003evendorParams\u003c/code\u003e allow for extra, vendor-specific data to be sent and received.\u003c/p\u003e\n"],["\u003cp\u003eThe API method may throw a \u003ccode\u003eCommonException\u003c/code\u003e with an \u003ccode\u003eAUTHORIZATION_FAILED\u003c/code\u003e, \u003ccode\u003eINTERNAL_SERVER_ERROR\u003c/code\u003e, or \u003ccode\u003eINVALID_PAGE_TOKEN\u003c/code\u003e error code if an error is encountered.\u003c/p\u003e\n"]]],["The `findDevicesByOwner` method retrieves a list of devices associated with specified customers. It requires a list of up to 100 customer references. Optional parameters include `pageSize` (up to 100 devices per page), `pageToken` for pagination, and `vendorParams`. The response includes a list of devices, `totalCount`, `nextPageToken`, and optional `vendorParams`. The method can throw a `CommonException` with `AUTHORIZATION_FAILED`, `INTERNAL_SERVER_ERROR`, or `INVALID_PAGE_TOKEN` errors.\n"],null,["# findDevicesByOwner\n\nLists devices claimed by the specified customer or customers.\n\nMethod signature\n----------------\n\n public FindDevicesResponse findDevicesByOwner(FindDevicesByOwnerRequest request) throws CommonException;\n\nFindDevicesByOwnerRequest\n-------------------------\n\n| Property name | Value | Required | Description |\n|----------------|---------------------------------------------------------------------------------------------------|----------|-----------------------------------------------------------------------------|\n| `customers` | `object(`[`CompanyReference`](/zero-touch/reseller-library/reference/objects#companyreference)`)` | Yes | List of up to 100 customers. |\n| `pageSize` | `int` | No | The page size, up to `100`. If greater than `100` or `null`, `100` is used. |\n| `pageToken` | `string` | No | The page token. If empty, the first page is returned. |\n| `vendorParams` | `map` | No | Extra fields, vendor specified key-value pair. |\n\nFindDevicesResponse\n-------------------\n\n| Property name | Value | Description |\n|-----------------|-------------------------------------------------------------------------------|---------------------------------------------------------------------------|\n| `devices` | `object(`[`Device`](/zero-touch/reseller-library/reference/objects#device)`)` | The list of devices uploaded by the reseller. Empty if there is no match. |\n| `totalCount` | `int` | The total count of devices matching the request. |\n| `nextPageToken` | `strong` | The next page token. Empty for the last page. |\n| `vendorParams` | `map` | Optional. Extra fields, vendor specified key-value pair. |\n\nError behaviour\n---------------\n\nIf an error occurs, the library throws a `CommonException` containing one of the\nfollowing error codes:\n\n| Error code |\n|-------------------------|\n| `AUTHORIZATION_FAILED` |\n| `INTERNAL_SERVER_ERROR` |\n| `INVALID_PAGE_TOKEN` |"]]
