Zoom Room metric data

API and Webhooks
1

Description
Trying to get details for a Zoom Room on my account by the ID

Error
The API claims the room can not be found, I know for a fact it exists because it shows up in the “List Zoom Rooms call”

Which App Type (OAuth / Chatbot / JWT / Webhook)?
JWT

Which Endpoint/s?
/metrics/zoomrooms/{zoomRoomID}

How To Reproduce (If applicable)
Steps to reproduce the behavior:

  1. Request URL / Headers (without credentials) / Body
    GET https://api.zoom.us/v2/metrics/zoomrooms/{zoomroomid}

Additional context
Worked prior to the recent change.

2

Hey @andrewb, thanks for posting and using Zoom!

Can you provide the Zoom Room ID here so I can debug.

Also can you please post the full error message?

Thanks,
Tommy

3

Hi Tommy,

I’m just listing the Zoom Rooms by this API: https://marketplace.zoom.us/docs/api-reference/zoom-api/rooms/listzoomrooms and then taking a random returned object and then using https://marketplace.zoom.us/docs/api-reference/zoom-api/dashboards/dashboardzoomroom to get the Zoom Room metrics.

When using an ID from the payload returned from the listing, it doesn’t work. An example ID is b52vmWppRJq5-8uisP7r3Q

4

Hey @andrewb,

Please be more specific and share the error, or full response paylod.

Thanks,
Tommy

5 
{ 
  code: 1012,
  message: 'Zoom Room \'b52vmWppRJq5-8uisP7r3Q\' not found'
}

Is the response

6

Hey @andrewb,

After looking into b52vmWppRJq5-8uisP7r3Q I believe the reason it is not found is because it is digital signage and not an actual Zoom Room.

Thanks,
Tommy

7

I did another FRRf7yM4TIqq3zKGKIXkAw which is a Zoom Room in our break room. Same response:

{
  code: 1012,
  message: 'Zoom Room \'FRRf7yM4TIqq3zKGKIXkAw\' not found'
}

Also it shows up in the list of Zoom Rooms, so I think there might be a bug.

8

Hey @andrewb,

Thanks for trying, we are investigating this and will get back to you. (ZOOM-143168)

-Tommy

9

Hey @andrewb,

We found the issue. Those ID’s that are not found, are actually not zoom room Ids, but userid of users which bind to the Zoom Rooms.

To get the list of zoom room Ids, use the List Zoom Room API.

The zoom room Ids of the two Zoom Rooms are B6X-sEzyR3-1GB0hlR1Thw and ZnHGMkpZRlmK23nKy3v88Q.

Thanks,
Tommy

10

Okay, then I think the documentation needs to be updated on here: https://marketplace.zoom.us/docs/api-reference/zoom-api/rooms/listzoomrooms. It specifically says in the returned payload ID is the Unique ID for the Zoom Room, not the User ID:

image
image1608×1252 161 KB

Also the ID that I provided FRRf7yM4TIqq3zKGKIXkAw correlates with what the resource_id is on the Zoom admin portal: https://zoom.us/location?resource_id=FRRf7yM4TIqq3zKGKIXkAw&resource_type=20 and was also the same ID that was returned in the payload from the API I previously linked to. To say it’s the user ID doesn’t make much sense with the documentation.

11

Hey @andrewb,

I agree, we will make this more clear.

Let me know if you have any trouble using the Zoom Room ids from the List Zoom Room API.

Thanks,
Tommy