Операция AddImContactToGroupAddImContactToGroup operation

Поиск сведений о AddImContactToGroupной операции EWS.Find information about the AddImContactToGroup EWS operation.

AddImContactToGroup веб-служб Exchange (EWS) добавляет в группу существующего контакта обмена мгновенными сообщениями (IM).The AddImContactToGroup Exchange Web Services (EWS) operation adds an existing instant messaging (IM) contact to a group.

Эта операция появилась в Exchange Server 2013.This operation was introduced in Exchange Server 2013.

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

Операция AddImContactToGroup может принимать только контакты для обмена мгновенными сообщениями.The AddImContactToGroup operation can only accept IM contacts. Если вы хотите добавить новый контакт для обмена мгновенными сообщениями в единое хранилище контактов, используйте операцию AddNewImContactToGroup .If you want to add a new IM contact to the Unified Contact Store, use the AddNewImContactToGroup operation.

Операция AddImContactToGroup может использовать заголовки SOAP, указанные в приведенной ниже таблице.The AddImContactToGroup operation can use the SOAP headers that are listed in the following table.

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

Имя заголовкаHeader name ЭлементElement ОписаниеDescription
ОлицетворениеImpersonation
ексчанжеимперсонатионExchangeImpersonation
Идентифицирует пользователя, который олицетворяет клиентское приложение.Identifies the user whom the client application is impersonating. Этот заголовок является применимым для запроса.This header is applicable to a request.
маилбокскултуреMailboxCulture
маилбокскултуреMailboxCulture
Определяет язык и региональные параметры, определенные в документе RFC 3066 "Теги для идентификации языков", которые будут использоваться для доступа к почтовому ящику.Identifies the culture, as defined in RFC 3066, "Tags for the Identification of Languages", to be used to access the mailbox. Этот заголовок является применимым для запроса.This header is applicable to a request.
рекуестверсионRequestVersion
рекуестсерверверсионRequestServerVersion
Определяет версию схемы для запроса операции.Identifies the schema version for the operation request. Этот заголовок является применимым для запроса.This header is applicable to a request.
серверверсионServerVersion
серверверсионинфоServerVersionInfo
Определяет версию сервера, который ответил на запрос.Identifies the version of the server that responded to the request. Этот заголовок является применимым для отклика.This header is applicable to a response.

Пример запроса операции AddImContactToGroup: Добавление существующего контакта для обмена мгновенными сообщениями в группу обмена мгновенными сообщениямиAddImContactToGroup operation request example: Add an existing IM contact to an IM group

В приведенном ниже примере запроса операции AddImContactToGroup показано, как добавить существующий обмен мгновенными сообщениями в группу обмена мгновенными сообщениями.The following example of an AddImContactToGroup operation request shows how to add an existing IM contact an IM group.

<?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" />
      <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 Request содержит следующие элементы:The request SOAP body contains the following elements:

Успешный отклик операции AddImContactToGroupSuccessful AddImContactToGroup operation response

В следующем примере показан успешный ответ на запрос операции AddImContactToGroup .The following example shows a successful response to an AddImContactToGroup operation request.

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

Тело SOAP отклика содержит следующие элементы:The response SOAP body contains the following elements:

Ответ об ошибке Ерроринвалидимконтактид операции AddImContactToGroupAddImContactToGroup operation ErrorInvalidImContactId error response

В следующем примере показан ответ об ошибке для запроса операции AddImContactToGroup .The following example shows an error response to an AddImContactToGroup operation request. При попытке добавить контакт, который не является контактом для обмена мгновенными сообщениями, возникает следующий ответ об ошибке.The following error response occurs when an attempt is made to add a contact that is not an IM contact.

<?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="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">
      <AddImContactToGroupResponse ResponseClass="Error" 
                                   xmlns="https://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 содержит следующие элементы:The error response SOAP body contains the following elements:

См. такжеSee also