Method: enterprises.devices.list
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Liệt kê các thiết bị do doanh nghiệp quản lý.
Yêu cầu HTTP
GET https://smartdevicemanagement.googleapis.com/v1/{parent=enterprises/*}/devices
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Tham số |
parent |
string
Doanh nghiệp mẹ liệt kê thiết bị trong đó. Ví dụ: "doanh nghiệp/XYZ".
|
Tham số truy vấn
| Tham số |
filter |
string
Bộ lọc không bắt buộc để liệt kê thiết bị. Bạn có thể thực hiện các bộ lọc trên: Tên tuỳ chỉnh của thiết bị (khớp chuỗi con): 'customName=wing'
|
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Thông báo phản hồi cho SmartDeviceManagementService.ListDevices
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
| Biểu diễn dưới dạng JSON |
{
"devices": [
{
object (Device)
}
]
} |
| Trường |
devices[] |
object (Device)
Danh sách thiết bị.
|
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/sdm.service
Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\u003cp\u003eLists all devices managed by a given enterprise, allowing for filtering by device custom name.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/sdm.service\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eUses a \u003ccode\u003eGET\u003c/code\u003e request to the specified endpoint with the enterprise ID as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides a list of devices in JSON format, including details for each device.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should be empty, while query parameters can be used to specify filters.\u003c/p\u003e\n"]]],[],null,["# Method: enterprises.devices.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListDevicesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Examples](#examples)\n\nLists devices managed by the enterprise.\n\n### HTTP request\n\n`GET https://smartdevicemanagement.googleapis.com/v1/{parent=enterprises/*}/devices`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------|\n| `parent` | `string` The parent enterprise to list devices under. E.g. \"enterprises/XYZ\". |\n\n### Query parameters\n\n| Parameters ||\n|----------|---------------------------------------------------------------------------------------------------------------------------|\n| `filter` | `string` Optional filter to list devices. Filters can be done on: Device custom name (substring match): 'customName=wing' |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for SmartDeviceManagementService.ListDevices\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------|\n| ``` { \"devices\": [ { object (/nest/device-access/reference/rest/v1/enterprises.devices#Device) } ] } ``` |\n\n| Fields ||\n|-------------|--------------------------------------------------------------------------------------------------------------|\n| `devices[]` | `object (`[Device](/nest/device-access/reference/rest/v1/enterprises.devices#Device)`)` The list of devices. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/sdm.service`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
