GetAppMarketplaceUrl operation
Published: July 16, 2012
Find information about the GetAppMarketplaceUrl EWS operation.
Applies to: Exchange Online | Exchange Server 2013
The GetAppMarketplaceUrl operation retrieves the URL for the app marketplace that a client can visit to acquire apps to install in a mailbox.
This operation was introduced in Exchange Server 2013.
The GetAppMarketplaceUrl operation does not take any arguments to request the URL for the marketplace from which a client can install apps. The response will contain a URL to the app marketplace.
GetAppMarketplaceUrl operation SOAP headers
The GetAppMarketplaceUrl operation can use the SOAP headers that are listed in the following table.
Header name | Element | Description |
|---|---|---|
RequestVersion | Identifies the schema version for the operation request. This header is applicable to a request. | |
ServerVersion | Identifies the version of the server that responded to the request. This header is applicable to a response. |
The following example of a GetAppMarketplaceUrl operation request shows how to get the app marketplace URL for a mailbox.
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">
<soap:Header>
<t:RequestServerVersion Version="Exchange2013" />
<t:MailboxCulture>en-US</t:MailboxCulture>
<t:TimeZoneContext>
<t:TimeZoneDefinition Id="GMT Standard Time"/>
</t:TimeZoneContext>
</soap:Header>
<soap:Body >
<m:GetAppMarketplaceUrl/>
</soap:Body>
</soap:Envelope>
The request SOAP body contains the following element:
The following example shows a successful response to a GetAppMarketplaceUrl operation request to get the app marketplace URL for a mailbox.
 Note |
|---|
The app marketplace URL has been altered to preserve readability. |
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:ServerVersionInfo MajorVersion="15"
MinorVersion="0"
MajorBuildNumber="556"
MinorBuildNumber="14"
Version="Exchange2013"
xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<GetAppMarketplaceUrlResponse ResponseClass="Success"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<ResponseCode>NoError</ResponseCode>
<AppMarketplaceUrl>http://marketplace.contoso.com</AppMarketplaceUrl>
</GetAppMarketplaceUrlResponse>
</s:Body>
</s:Envelope>
The response SOAP body contains the following elements:
Because the GetAppMarketPlaceUrl operation does not take any arguments, errors returned for this operation are either related to an incorrect service configuration or are generic EWS errors. For error codes that are generic to EWS and specific to this operation, see ResponseCode.
The following example shows an error response that is returned when external Exchange Control Panel (ECP) is not configured.
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:ServerVersionInfo MajorVersion="15"
MinorVersion="0"
MajorBuildNumber="526"
MinorBuildNumber="0"
Version="Exchange2013"
xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<GetAppMarketplaceUrlResponse ResponseClass="Error"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<MessageText>Cannot get external ECP URL. This might happen if external ECP URL isn't configured.</MessageText>
<ResponseCode>ErrorCannotGetExternalEcpUrl</ResponseCode>
<DescriptiveLinkKey>0</DescriptiveLinkKey>
</GetAppMarketplaceUrlResponse>
</s:Body>
</s:Envelope>
The error response SOAP body contains the following elements:
Date | Description |
|---|---|
July 16, 2012 | Initial publication |
