findDevicesByIdentifier

يعرض الأجهزة التي تحمل معرّف جهاز معيّنًا.

توقيع الطريقة

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