This documentation is archived and is not being maintained.

GetSeatsReserved Message

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

Gets the total seats reserved during a specified time period.

Component Type

XML Element

Request

GetSeatsReservedRequest

Reply

GetSeatsReservedReply

A caller must be a member of the Administrator or Organizer role.

This message is useful for determining the number of licensed seats available for the time interval specified by the query. It can be used to avoid overbooking the conference center.

The following shows a request to determine how many seats are reserved between 10:00 and 12:00 on 1 March, 2001, in a conference center.

<PlaceWareConfCenter authUser="apiuser" authPassword="Pa$$w0rd">
  <GetSeatsReservedRequest>
    <TimeInterval startTime="2001-03-01T10:00:00Z" endTime="2001-03-01T12:00:00Z"/>
  </GetSeatsReservedRequest>
</PlaceWareConfCenter>

The following shows a reply from the conference center. The details depend on the state of your conference center.

<PlaceWareConfCenter>
  <GetSeatsReservedReply>
    <SeatsReserved maxUsers="20">
      <TimeInterval startTime="2001-03-01T10:00:00Z" endTime="2001-03-01T10:30:00Z"/>
    </SeatsReserved>
    <SeatsReserved maxUsers="30">
      <TimeInterval startTime="2001-03-01T10:30:00Z" endTime="2001-03-01T11:00:00Z"/>
    </SeatsReserved>
    <SeatsReserved maxUsers="0">
      <TimeInterval startTime="2001-03-01T11:00:00Z" endTime="2001-03-01T11:02:59Z"/>
    </SeatsReserved>
    <SeatsReserved maxUsers="99">
      <TimeInterval startTime="2001-03-01T11:02:59Z" endTime="2001-03-01T12:00:00Z"/>
    </SeatsReserved>
  </GetSeatsReservedReply>
</PlaceWareConfCenter>

Twenty seats are reserved between 10:00 and 10:30. At 10:30, the number of reserved seats increases to 30. If this conference center's license limit is 100 seats, you could schedule a finite meeting from 10:00 to 11:00 with a maxUsers value of at most 70. At 11:00, no seats are reserved, but at 11:02:59, the remaining seats are reserved.

All the times are represented in UTC format. The time interval for the query might need to be converted from local time to UTC by the sending application.

Show: