يعرض الأجهزة التي تحمل معرّف جهاز معيّنًا.
توقيع الطريقة
public FindDevicesResponse findDevicesByDeviceIdentifier(FindDevicesByDeviceIdentifierRequest request) throws CommonException;
FindDevicesByDeviceIdentifierRequest
| اسم الموقع |
القيمة |
مطلوب |
الوصف |
deviceIdentifier |
object(DeviceIdentifier) |
نعم |
معرّف الجهاز المطلوب استرداده يمكن تعبئة العنصر جزئيًا. |
pageSize |
int |
لا |
حجم الصفحة، بحد أقصى 100 إذا كانت القيمة أكبر من 100 أو null، يتم استخدام 100. |
pageToken |
string |
لا |
الرمز المميّز للصفحة إذا كانت فارغة، يتم عرض الصفحة الأولى. |
vendorParams |
map |
لا |
حقول إضافية، يحدد المورّد زوج المفتاح/القيمة. |
FindDevicesResponse
| اسم الموقع |
القيمة |
الوصف |
devices |
object(Device) |
قائمة الأجهزة التي حمّلها المورّد يكون الحقل فارغًا في حال عدم وجود مطابقة. |
totalCount |
int |
إجمالي عدد الأجهزة التي تتطابق مع الطلب |
nextPageToken |
strong |
الرمز المميّز للصفحة التالية. فارغ للصفحة الأخيرة. |
vendorParams |
map |
اختياريّ. الحقول الإضافية، زوج المفتاح/القيمة المحدّد من المورّد |
سلوك الخطأ
في حال حدوث خطأ، تُرسِل المكتبة CommonException يحتوي على أحد رمزَي الخطأ التاليَين:
| رمز الخطأ |
INTERNAL_SERVER_ERROR |
INVALID_PAGE_TOKEN |
