List Zoom Room locations

GET

/rooms/locations

A Zoom account owner or a Zoom Room administrator can establish a location hierarchy to help manage Zoom Rooms that are spread among a variety of locations. Use this API to list the different location types used for Zoom Rooms in an account.

Prerequisites:

Account owner or admin permissions.

Zoom Rooms Version 4.0 or higher

Scopes: room:read:admin

Rate Limit Label: Medium

请求示例

Shell

JavaScript

Java

Swift

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

响应示例

200 - response

{
  "page_size": 30,
  "next_page_token": "",
  "locations": [
    {
      "id": "AAAAAAAAAA",
      "name": "Country/Region1",
      "parent_location_id": "I-qsfdUbbbbg",
      "type": "country"
    },
    {
      "id": "BBBBBBBB",
      "name": "State1",
      "parent_location_id": "AAAAAAAAAA",
      "type": "state"
    },
    {
      "id": "ccccddddd,
      "name": "City1",
      "parent_location_id": "BBBBBBBB",
      "type": "city"
    },
    {
      "id": "fgaajfjfhgjgjgjg",
      "name": "Campus1",
      "parent_location_id": "ccccddddd,
      "type": "campus"
    },
    {
      "id": "YQGK12344",
      "name": "Building1",
      "parent_location_id": "fgaajfjfhgjgjgjg",
      "type": "building"
    },
    {
      "id": "uUbbbbbbbb",
      "name": "Floor1",
      "parent_location_id": "YQGK12344",
      "type": "floor"
    }
  ]
}

请求参数

Query 参数

返回响应

🟢200**HTTP Status Code:** `200` **OK** Zoom Room locations listed successfully.

application/json

Body

🟠400**HTTP Status Code:** `400` **Bad Request** **Error Code:** `200` Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription. **Error Code:** `300` Location type not exist.

🟠404**HTTP Status Code:** `404` **Not Found** **Error Code:** `4801` Location not found:{parent_location_id}.

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

Update Zoom Room account settings

Add a location