Поделиться через

Операция AddImContactToGroup

  • Статья

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

Операция AddImContactToGroup Exchange Web Services (EWS) добавляет существующий контакт обмена мгновенными сообщениями (IM) в группу.

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

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

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

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

Таблица 1. Заголовки SOAP операции AddImContactToGroup

Имя заголовка Элемент Описание
Олицетворения
ExchangeImpersonation
Определяет пользователя, которого олицетворяет клиентское приложение. Этот заголовок применим к запросу.
MailboxCulture
MailboxCulture
Определяет язык и региональные параметры, определенные в RFC 3066 "Теги для идентификации языков", которые будут использоваться для доступа к почтовому ящику. Этот заголовок применим к запросу.
RequestVersion
RequestServerVersion
Определяет версию схемы для запроса операции. Этот заголовок применим к запросу.
ServerVersion
ServerVersionInfo
Определяет версию сервера, который ответил на запрос. Этот заголовок применим к ответу.

Пример запроса на операцию AddImContactToGroup: добавление существующего контакта для обмена мгновенными сообщениями в группу обмена мгновенными сообщениями

В следующем примере запроса на операцию AddImContactToGroup показано, как добавить существующий обмен мгновенными сообщениями в группу обмена мгновенными сообщениями.

<?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>
   </soap:Header>
   <soap:Body >
      <m:AddImContactToGroup>
         <m:ContactId Id="AAMkAGQ1MjJjMTBkLTc4Y2AA="
                      ChangeKey="EQAAABYAAABtF8oI7i"/>
         <m:GroupId Id="AAMkAGQ1MjJjMTBkzzAAAQKAAA="
                    ChangeKey="EgAAAA=="/>
      </m:AddImContactToGroup>
   </soap:Body>
</soap:Envelope>

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

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

В следующем примере показан успешный ответ на запрос операции AddImContactToGroup .

<?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="349" 
                           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">
      <AddImContactToGroupResponse ResponseClass="Success" 
                                   xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
         <ResponseCode>NoError</ResponseCode>
      </AddImContactToGroupResponse>
   </s:Body>
</s:Envelope>

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

Ответ операции AddImContactToGroup ErrorInvalidImContactId

В следующем примере показан ответ на ошибку на запрос операции AddImContactToGroup . Следующий ответ об ошибке возникает при попытке добавить контакт, который не является контактом для обмена мгновенными сообщениями.

<?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="349" 
                           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">
      <AddImContactToGroupResponse ResponseClass="Error" 
                                   xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
         <MessageText>The specified Im Contact Id is invalid.</MessageText>
         <ResponseCode>ErrorInvalidImContactId</ResponseCode>
         <DescriptiveLinkKey>0</DescriptiveLinkKey>
         </AddImContactToGroupResponse>
      </s:Body>
</s:Envelope>

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

См. также