findDevicesByOwner
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
دستگاه های ادعا شده توسط مشتری یا مشتریان مشخص شده را فهرست می کند.
امضای روش
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 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\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` |"]]
