기기 찾기 소유자
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
지정된 고객이 소유권을 주장하는 기기를 나열합니다.
메서드 서명
public FindDevicesResponse findDevicesByOwner(FindDevicesByOwnerRequest request) throws CommonException;
FindDevicesByOwnerRequest
| 속성 이름 |
값 |
필수 |
설명 |
customers |
object(CompanyReference) |
예 |
최대 100명의 고객 목록입니다. |
pageSize |
int |
아니요 |
페이지 크기(최대 100)입니다. 100 또는 null보다 크면 100가 사용됩니다. |
pageToken |
string |
아니요 |
페이지 토큰입니다. 비어 있으면 첫 번째 페이지가 반환됩니다. |
vendorParams |
map |
아니요 |
추가 필드, 공급업체가 지정한 키-값 쌍입니다. |
FindDevicesResponse
| 속성 이름 |
값 |
설명 |
devices |
object(Device) |
리셀러가 업로드한 기기 목록입니다. 일치하는 항목이 없으면 비어 있습니다. |
totalCount |
int |
요청과 일치하는 기기의 총 개수입니다. |
nextPageToken |
strong |
다음 페이지 토큰입니다. 마지막 페이지의 경우 비어 있습니다. |
vendorParams |
map |
선택사항입니다. 추가 필드, 공급업체가 지정한 키-값 쌍입니다. |
오류 동작
오류가 발생하면 라이브러리는 다음 오류 코드 중 하나가 포함된 CommonException를 발생시킵니다.
| 오류 코드 |
AUTHORIZATION_FAILED |
INTERNAL_SERVER_ERROR |
INVALID_PAGE_TOKEN |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(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,["Lists devices claimed by the specified customer or customers.\n\nMethod signature \n\n public FindDevicesResponse findDevicesByOwner(FindDevicesByOwnerRequest request) throws CommonException;\n\nFindDevicesByOwnerRequest\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| 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\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` |"]]
