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