GetURL 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 URL corresponding to a specified resource to be uploaded to or downloaded from the conference center.

Components

Component Type	XML Element
Request	GetURLRequest Element
Reply	GetURLReply Element

Remarks

A caller must be a member of the Administrator or Organizer role. Only ESS and PWP formatted packages can be uploaded and only recordings can be downloaded. The creation of an ESS-formatted package is not covered in this documentation.

Examples

Example 1

The following request gets the URL for a WindowsMediaMovieRecordingDownload resourceType. This request is made on a Live Meeting conference center.

<PlaceWareConfCenter authUser="apiuser" authPassword="Pa$$w0rd">
  <GetURLRequest>
    <StringQuery fieldName="name" operator="=" value="ZTB93J-1"/>
    <OptionList>
      <StringOption name="recViewerCompany" value="Contoso Corporation"/>
      <StringOption name="recViewerName" value="john"/>
      <StringOption name="recViewerEmail" value="john@contoso.com"/>
      <EnumerationOption name="resourceType" value="WindowsMediaMovieRecordingDownload">
        <String>ESS</String>
        <String>PWP</String>
        <String>HighFidelityPresentation</String>
        <String>HighFidelityPresentationDownload</String>
        <String>WindowsMediaMovieRecording</String>
        <String>WindowsMediaMovieRecordingDownload</String>
        <String>BasicRecording</String>
      </EnumerationOption>
    </OptionList>
  </GetURLRequest>
</PlaceWareConfCenter>
GetServiceUnavailableTimesRequest Element
GetServiceUnavailableTimesReply Element

The following shows a reply returned from the conference center. You can use the resultant URL to download the resource.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<PlaceWareConfCenter>
  <GetURLReply url=" https://www119.livemeeting.com/cc/_XML/contoso/view?id=8G2G4J&amp;fmt=dll&amp;pw=&amp;cn=john&amp;email=john@contoso.com&amp;company=Example Corporation"></GetURLReply>
</PlaceWareConfCenter>

Example 2

The following XML request gets the URL for a streaming media resourceType.

<PlaceWareConfCenter authUser="apiuser" authPassword="Pa$$w0rd">
  <GetURLRequest>
    <StringQuery fieldName="name" operator="=" value="ZTB93J-1"/>
    <OptionList>
      <StringOption name="recViewerCompany" value="Contoso Corporation"/>
      <StringOption name="recViewerName" value="John"/>
      <StringOption name="recViewerEmail" value="john@contoso.com"/>
      <EnumerationOption name="resourceType" value="WindowsMediaMovieRecording">
        <String>ESS</String>
        <String>PWP</String>
        <String>HighFidelityPresentation</String>
        <String>HighFidelityPresentationDownload</String>
        <String>WindowsMediaMovieRecording</String>
        <String>WindowsMediaMovieRecordingDownload</String>
        <String>BasicRecording</String>
      </EnumerationOption>
    </OptionList>
  </GetURLRequest>
</PlaceWareConfCenter>

The following shows the response. The returned URL opens the streaming media that is referenced.

<PlaceWareConfCenter>
  <GetURLReply url="https://www119.livemeeting.com/cc/_XML/contoso/view?id=8G2G4J&amp;fmt=lmm&amp;pw=&amp;cn=john&amp;email=john@contoso.com&amp;company=Contoso Corporation"></GetURLReply>
</PlaceWareConfCenter>

Example 3

Next, you want to upload and display a slide set named strategy-slides to the meeting named strategy. In this example, you upload a slide to a Live Meeting conference center. The slide set is in ESS format and contains exactly 102,963 bytes. You want to use HTTP for the upload. To get the URL, you send the following code.

<PlaceWareConfCenter authUser="apiuser" authPassword="Pa$$w0rd">
  <GetURLRequest>
    <StringQuery fieldName="name" operator="=" value="strategy"/>
    <OptionList>
      <DecimalOption name="bytes" value="102963"/>
      <BooleanOption name="isUpload" value="True"/>
      <EnumerationOption name="resourceType" value="ESS">
        <String>ESS</String>
        <String>PWP</String>
        <String>HighFidelityPresentation</String>
        <String>HighFidelityPresentationDownload</String>
        <String>WindowsMediaMovieRecording</String>
        <String>WindowsMediaMovieRecordingDownload</String>
        <String>BasicRecording</String>
      </EnumerationOption>
      <BooleanOption name="showSlideSet" value="True"/>
      <StringOption name="uploadName" value="strategy-slides"/>
    </OptionList>
  </GetURLRequest>
</PlaceWareConfCenter>

The following shows the XML reply.

<PlaceWareConfCenter>
  <GetURLReply
    url="http://www119.livemeeting.com/cc/contoso/mass/4k15dbv6c6656" />
</PlaceWareConfCenter>

As soon as the reply is received, send the contents of the strategy-slides file to the URL http://www119.livemeeting.com/cc/contoso/mass/4k15dbv6c6656 in one HTTP POST. The following shows the XML reply from that POST.

<PlaceWareConfCenter>
  <MassTransferReply>
    <InfoWarnFaultList>
      <InfoWarn>
        <Code>Info.Server.Success.Upload.SlideSet</Code>
        <OptionList>
          <TimeOption name="time" value="2002-08-08T17:20:24Z"/>
        </OptionList>
      </InfoWarn>
    </InfoWarnFaultList>
  </MassTransferReply>
</PlaceWareConfCenter>

See Also

Concepts

GetURLRequest Element

GetURLReply Element