البحث عن الأجهزة حسب المالك
يعرض هذا التقرير الأجهزة التي طالب بها العميل أو العملاء المحدّدون.
توقيع الطريقة
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 و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-11-09 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-11-09 (حسب التوقيت العالمي المتفَّق عليه)"],[[["This API method `findDevicesByOwner` retrieves a list of devices associated with specified customers."],["The request requires a list of up to 100 `customers` (CompanyReference objects), and supports pagination via `pageSize` and `pageToken`."],["The response includes a list of `devices`, the `totalCount` of matching devices, and a `nextPageToken` for subsequent pages."],["Optional parameters such as `vendorParams` allow for extra, vendor-specific data to be sent and received."],["The API method may throw a `CommonException` with an `AUTHORIZATION_FAILED`, `INTERNAL_SERVER_ERROR`, or `INVALID_PAGE_TOKEN` error code if an error is encountered."]]],["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"]]
