List Zoom Room devices

GET

/rooms/{roomId}/devices

List information about the devices that are being used for a specific Zoom Room in an account.

Prerequisites:

Pro or a higher plan with Zoom Room license.

Account owner or admin permissions.
Scopes: room:read:admin
Rate Limit Label: Medium

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'http://api.zoom.us/v2/rooms//devices'

响应示例

200 - response

{
    "devices": [
        {
            "app_version": "4.4.1 (1242.0623)",
            "device_system": "Win 10",
            "device_type": "Zoom Rooms Computer",
            "id": "sajhdfshf24324",
            "room_name": "MyAwesomeZoomRoom",
            "status": "Online"
        },
        {
            "app_version": "4.3.6 (265.0307)",
            "device_system": "iPad 12.3.1",
            "device_type": "Zoom Rooms Controller",
            "id": "32dhgdfg2were",
            "room_name": "MyAwesomeZoomRoom",
            "status": "Online"
        }
    ]
}

请求参数

Path 参数

roomId

string

必需

Unique Identifier of the Zoom Room. This can be retrieved from the response of List Zoom Rooms API.

返回响应

🟢200**HTTP Status Code:** `200` **OK** Devices listed successfully.

application/json

Body

devices

array [object {6}]

可选

app_version

string

可选

App version of Zoom Rooms.

device_system

string

可选

Operating system of the device.

device_type

enum<string>

可选

Type of the device. The value of this field can be one of the following:
Zoom Rooms Computer,
Controller, Scheduling Display, Zoom Rooms Control System, Companion Whiteboard

枚举值:

Zoom Rooms ComputerControllerScheduling DisplayZoom Rooms Control SystemCompanion Whiteboard

string

可选

Unique identifier of the device.

room_name

string

可选

Name of the Zoom Room.

status

enum<string>

可选

Status of the device. The value can be either Online or Offline.

枚举值:

OnlineOffline

🟠400**HTTP Status Code:** `400` **Bad Request**<br> **Error Code:** `200`<br> Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription.

修改于 2024-04-24 09:06:48

Update a Zoom Room profile

Change a Zoom Room's location