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 |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-11-09 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-11-09 (حسب التوقيت العالمي المتفَّق عليه)"],[[["This method retrieves a list of devices based on a provided device identifier."],["The request requires a `deviceIdentifier` object, which can be partially filled, to specify the devices to be retrieved."],["Optional parameters include `pageSize` (up to 100), `pageToken` for pagination, and `vendorParams` for extra data."],["The response contains a list of `devices`, the `totalCount` of matching devices, an optional `nextPageToken` for additional pages, and `vendorParams` for extra information."],["Potential errors during the process will result in a `CommonException` being thrown, with possible error codes being `INTERNAL_SERVER_ERROR` or `INVALID_PAGE_TOKEN`."]]],[]]