Операция GetAppManifests

Статья
03/29/2023

Найдите сведения об операции GetAppManifests EWS.

Операция GetAppManifests извлекает манифесты приложения.

Эта операция появилась в Exchange Server 2013.

Использование операции GetAppManifests

Операция GetAppManifests не принимает аргументы для запроса манифестов приложения для почтового ящика. Ответ будет содержать XML-файлы манифеста в кодировке Base64 для каждого приложения, установленного в почтовом ящике.

Заголовки SOAP операции GetAppManifests

Операция GetAppManifests может использовать заголовки SOAP, перечисленные в следующей таблице.

Имя заголовка	Элемент	Описание
RequestVersion	RequestServerVersion	Определяет версию схемы для запроса операции. Этот заголовок применим к запросу.
ServerVersion	ServerVersionInfo	Определяет версию сервера, который ответил на запрос. Этот заголовок применим к ответу.

Пример запроса на операцию GetAppManifests. Получение манифестов приложения для почтового ящика

В следующем примере запроса на операцию GetAppManifests показано, как получить манифесты приложения для почтового ящика. Элементы ApiVersionSupported и SchemaVersionSupported являются необязательными.

<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
               xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages">
   <soap:Header>
      <t:RequestServerVersion Version="Exchange2013_SP1" />
      <t:MailboxCulture>en-US</t:MailboxCulture>
      <t:TimeZoneContext>
         <t:TimeZoneDefinition Id="GMT Standard Time"/>
      </t:TimeZoneContext>
   </soap:Header>
   <soap:Body >
      <m:GetAppManifests>
        <m:ApiVersionSupported>1.1</m:ApiVersionSupported>
        <m:SchemaVersionSupported>1.1</m:SchemaVersionSupported>
      </m:GetAppManifests>
   </soap:Body>
</soap:Envelope>

Текст SOAP запроса содержит следующий элемент:

Успешный ответ на операцию GetAppManifests

В следующем примере показан успешный ответ на запрос операции GetAppManifests для получения манифестов приложения для почтового ящика.

Примечание.

Все манифесты приложений Base64 были произвольно усечены для сохранения удобочитаемости.

<?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="918" 
                           MinorBuildNumber="07" 
                           Version="V2_10" 
                           xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns="https://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">
      <GetAppManifestsResponse ResponseClass="Success" 
                               xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <ResponseCode>NoError</ResponseCode>
         <m:Apps xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages">
          <t:App xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
            <t:Manifest>WNlQXBwPg==</t:Manifest>
          </t:App>
         </m:Apps>
      </GetAppManifestsResponse>
   </s:Body>
</s:Envelope>

Текст SOAP ответа содержит следующие элементы:

Текст SOAP ответа также может содержать следующий элемент:

Манифесты

Ответ на ошибку операции GetAppManifests

Ошибки, возвращаемые для этой операции, связаны с недопустимым форматом входных параметров или являются общими ошибками EWS. Коды ошибок, которые являются общими для EWS и относятся к этой операции, см. в разделе ResponseCode.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <ServerVersionInfo MajorVersion="15"
                       MinorVersion="0"
                       MajorBuildNumber="918"
                       MinorBuildNumber="07"
                       Version="V2_10"
                       xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types"
                       xmlns="https://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">
    <GetAppManifestsResponse ResponseClass="Error"
                             xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <MessageText>The apiVersionSupported parameter is invalid. 
                   It should be in the form of major version, minor 
                   version, separated by '.', for example '2.34'.</MessageText>
      <ResponseCode>ErrorInvalidRequest</ResponseCode>
      <DescriptiveLinkKey>0</DescriptiveLinkKey>
    </GetAppManifestsResponse>
  </s:Body>
</s:Envelope>