findDevicesByOwner
Stay organized with collections
Save and categorize content based on your preferences.
Lists devices claimed by the specified customer or customers.
Method signature
public FindDevicesResponse findDevicesByOwner(FindDevicesByOwnerRequest request) throws CommonException;
FindDevicesByOwnerRequest
| Property name |
Value |
Required |
Description |
customers |
object(CompanyReference) |
Yes |
List of up to 100 customers. |
pageSize |
int |
No |
The page size, up to 100. If greater than 100 or null, 100 is used. |
pageToken |
string |
No |
The page token. If empty, the first page is returned. |
vendorParams |
map |
No |
Extra fields, vendor specified key-value pair. |
FindDevicesResponse
| Property name |
Value |
Description |
devices |
object(Device) |
The list of devices uploaded by the reseller. Empty if there is no match. |
totalCount |
int |
The total count of devices matching the request. |
nextPageToken |
strong |
The next page token. Empty for the last page. |
vendorParams |
map |
Optional. Extra fields, vendor specified key-value pair. |
Error behaviour
If an error occurs, the library throws a CommonException containing one of the
following error codes:
| Error code |
AUTHORIZATION_FAILED |
INTERNAL_SERVER_ERROR |
INVALID_PAGE_TOKEN |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-28 UTC.
[null,null,["Last updated 2025-08-28 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` |"]]