البحث عن الأجهزة حسب المالك
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يعرض هذا التقرير الأجهزة التي طالب بها العميل أو العملاء المحدّدون.
توقيع الطريقة
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. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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` |"]]
