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 |
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-08-29 UTC
[null,null,["อัปเดตล่าสุด 2025-08-29 UTC"],[[["\u003cp\u003eThis method retrieves a list of devices based on a provided device identifier.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires a \u003ccode\u003edeviceIdentifier\u003c/code\u003e object, which can be partially filled, to specify the devices to be retrieved.\u003c/p\u003e\n"],["\u003cp\u003eOptional parameters include \u003ccode\u003epageSize\u003c/code\u003e (up to 100), \u003ccode\u003epageToken\u003c/code\u003e for pagination, and \u003ccode\u003evendorParams\u003c/code\u003e for extra data.\u003c/p\u003e\n"],["\u003cp\u003eThe response contains a list of \u003ccode\u003edevices\u003c/code\u003e, the \u003ccode\u003etotalCount\u003c/code\u003e of matching devices, an optional \u003ccode\u003enextPageToken\u003c/code\u003e for additional pages, and \u003ccode\u003evendorParams\u003c/code\u003e for extra information.\u003c/p\u003e\n"],["\u003cp\u003ePotential errors during the process will result in a \u003ccode\u003eCommonException\u003c/code\u003e being thrown, with possible error codes being \u003ccode\u003eINTERNAL_SERVER_ERROR\u003c/code\u003e or \u003ccode\u003eINVALID_PAGE_TOKEN\u003c/code\u003e.\u003c/p\u003e\n"]]],["The `findDevicesByDeviceIdentifier` method retrieves a list of devices based on a provided device identifier. The request requires a `deviceIdentifier`, and optionally accepts `pageSize` (up to 100), `pageToken`, and `vendorParams`. The response includes a list of `devices`, `totalCount`, `nextPageToken`, and optional `vendorParams`. Errors result in a `CommonException`, with codes like `INTERNAL_SERVER_ERROR` or `INVALID_PAGE_TOKEN`.\n"],null,["# findDevicesByIdentifier\n\nLists devices with given device identifier.\n\nMethod signature\n----------------\n\n public FindDevicesResponse findDevicesByDeviceIdentifier(FindDevicesByDeviceIdentifierRequest request) throws CommonException;\n\nFindDevicesByDeviceIdentifierRequest\n------------------------------------\n\n| Property name | Value | Required | Description |\n|--------------------|---------------------------------------------------------------------------------------------------|----------|-----------------------------------------------------------------------------------------|\n| `deviceIdentifier` | `object(`[`DeviceIdentifier`](/zero-touch/reseller-library/reference/objects#deviceidentifier)`)` | Yes | Device identifier of the devices to be retrieve. The object can be partially populated. |\n| `pageSize` | `int` | No | The page size, up to `100`. If greater than `100` or `null`, `100` is used. |\n| `pageToken` | `string` | No | The page token. If empty, the first page is returned. |\n| `vendorParams` | `map` | No | Extra fields, vendor specified key-value pair. |\n\nFindDevicesResponse\n-------------------\n\n| Property name | Value | Description |\n|-----------------|-------------------------------------------------------------------------------|---------------------------------------------------------------------------|\n| `devices` | `object(`[`Device`](/zero-touch/reseller-library/reference/objects#device)`)` | The list of devices uploaded by the reseller. Empty if there is no match. |\n| `totalCount` | `int` | The total count of devices matching the request. |\n| `nextPageToken` | `strong` | The next page token. Empty for the last page. |\n| `vendorParams` | `map` | Optional. Extra fields, vendor specified key-value pair. |\n\nError behavior\n--------------\n\nIf an error occurs, the library throws a `CommonException` containing one of the\nfollowing error codes:\n\n| Error code |\n|-------------------------|\n| `INTERNAL_SERVER_ERROR` |\n| `INVALID_PAGE_TOKEN` |"]]