Companywebcast API Wiki

The MetaService exposes 2 methods that you can use to find webcasts and retrieve their metadata. You'll need to explain to the MetaService which data you're after, and below is the list of input parameters that you can do that with.

Table of Contents [Hide/Show]


      WebcastSearch
      WebcastGet


Typically a client would call WebcastSearch to retrieve WebcastSummaries, which give some basic info about the webcasts that match the search parameters. A client would then use elements from a WebcastSummary as input parameters for a call to WebcastGet. WebcastGet returns a Webcast object, which contains detailed information about a single webcast, in a single language.

Edit

WebcastSearch


Username
Required, a string. The user name provided to you by Companywebcast that allows access to the Webcast Management System, or was specifically created for consuming the MetaService.
Password
Required, a string. The password provided to you by Companywebcast that allows access to the Webcast Management System, or was specifically created for consuming the MetaService.
OwnerName
Optional, a string. The (partial) name of the person or organization that commissioned the Webcast. If you do not set OwnerName, you'll search in all Webcasts your MetaService account has access to.
TopicTitle
Optional, a string. The (partial) title of a topic that was discussed during a Webcast.
SpeakerLastName
Optional, a string. The (partial) last name of a speaker who was present during a Webcast.
WebcastTitle
Optional, a string. The (partial) title of a Webcast.
PeriodFrom
Optional, a DateTime/Calendar. The date and time at which to start WebcastSearch. Older webcasts will not be returned. Note that all dates and times used throughout the MetaService are UTC. You will have to compensate for your timezone when working with any DateTime in the MetaService.
PeriodTo
Optional, a DateTime/Calendar. The date and time at which to end WebcastSearch. Newer webcasts will not be returned. Note that all dates and times used throughout the MetaService are UTC. You will have to compensate for your timezone when working with any DateTime in the MetaService.
Status
Optional, an enumeration of type WebcastStatus. Multiple values can be set.
PageSize
Optional, an integer. The maximum amount of results returned by WebcastSearch. Note that WebcastSearch can not return more than 100 results per call, and attempting to do so will result in an error.
PageNumber
Optional, an integer. The amount of results returned by WebcastSearch is less or equal to the value of PageSize, with a maximum of 100. If more results are available they are spread out across Pages, which you can navigate with PageNumber. The first page is 0.


returns:
Look at Data returned by the MetaService for more information.

WebcastSearchResult
An integer that indicates the success or failure of your WebcastSearch request.
WebcastSummaries
A list of WebcastSummary objects. A WebcastSummary object contains basic information about a Webcast, and elements you need for WebcastGet.

Edit

WebcastGet


Username
Required, a string. The username provided to you by Companywebcast that allows access to the Webcast Management System, or was specifically created for consuming the MetaService.
Password
Required, a string. The password provided to you by Companywebcast that allows access to the Webcast Management System, or was specifically created for consuming the MetaService.
Code
Required, a string. Uniquely identifies the Webcast for which you want to retrieve metadata. To find out what the Code of a Webcast is, call WebcastSearch to retrieve a WebcastSummary and use its Code property.
Language
Optional, a string. The language for which you want to retrieve metadata. To find out which languages are available for a Webcast, call WebcastSearch to retrieve a WebcastSummary and use its Languages property. If you don't set a language, the default language will be returned.


returns:
Look at Data returned by the MetaService for more information.

WebcastGetResult
An integer that indicates the success or failure of your WebcastGet request.
Webcast
A Webcast object. The Webcast object contains detailed information about a Webcast.