Opération AddImContactToGroupAddImContactToGroup operation

Trouvez des informations sur l’opération EWS AddImContactToGroup .Find information about the AddImContactToGroup EWS operation.

L’opération AddImContactToGroup les services Web Exchange (EWS) ajoute un contact de messagerie instantanée à un groupe.The AddImContactToGroup Exchange Web Services (EWS) operation adds an existing instant messaging (IM) contact to a group.

Cette opération est une nouveauté d’Exchange Server 2013.This operation was introduced in Exchange Server 2013.

Utilisation de l’opération AddImContactToGroupUsing the AddImContactToGroup operation

L’opération AddImContactToGroup peut accepter uniquement les contacts de messagerie instantanée.The AddImContactToGroup operation can only accept IM contacts. Si vous souhaitez ajouter un nouveau contact de messagerie instantanée au magasin de contacts unifié, utilisez l’opération AddNewImContactToGroup .If you want to add a new IM contact to the Unified Contact Store, use the AddNewImContactToGroup operation.

L’opération AddImContactToGroup peut utiliser les en-têtes SOAP répertoriés dans le tableau suivant.The AddImContactToGroup operation can use the SOAP headers that are listed in the following table.

Tableau 1. En-têtes SOAP d’opération AddImContactToGroupTable 1. AddImContactToGroup operation SOAP headers

Nom de l'en-têteHeader name ÉlémentElement DescriptionDescription
Emprunt d’identitéImpersonation
ExchangeImpersonationExchangeImpersonation
Identifie l’utilisateur qui emprunte l’identité de l’application cliente.Identifies the user whom the client application is impersonating. Cet en-tête s’applique à une demande.This header is applicable to a request.
MailboxCultureMailboxCulture
MailboxCultureMailboxCulture
Identifie la culture, telle que définie dans la norme RFC 3066, « balises pour l’identification des langues », à utiliser pour accéder à la boîte aux lettres.Identifies the culture, as defined in RFC 3066, "Tags for the Identification of Languages", to be used to access the mailbox. Cet en-tête s’applique à une demande.This header is applicable to a request.
RequestVersionRequestVersion
RequestServerVersionRequestServerVersion
Identifie la version de schéma de la demande d’opération.Identifies the schema version for the operation request. Cet en-tête s’applique à une demande.This header is applicable to a request.
ServerVersionServerVersion
ServerVersionInfoServerVersionInfo
Identifie la version du serveur qui a répondu à la demande.Identifies the version of the server that responded to the request. Cet en-tête s’applique à une réponse.This header is applicable to a response.

Exemple de requête d’opération AddImContactToGroup : ajouter un contact de messagerie instantanée existant à un groupe de messagerie instantanéeAddImContactToGroup operation request example: Add an existing IM contact to an IM group

L’exemple suivant de demande d’opération AddImContactToGroup indique comment ajouter un contact de messagerie instantanée existant à un groupe de messagerie instantanée.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>

Le corps SOAP de la demande contient les éléments suivants :The request SOAP body contains the following elements:

Réponse de l’opération AddImContactToGroup réussieSuccessful AddImContactToGroup operation response

L’exemple suivant montre une réponse réussie à une demande d’opération 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>

Le corps SOAP de réponse contient les éléments suivants :The response SOAP body contains the following elements:

AddImContactToGroup Operation ErrorInvalidImContactId Error ResponseAddImContactToGroup operation ErrorInvalidImContactId error response

L’exemple suivant montre une réponse d’erreur à une demande d’opération AddImContactToGroup .The following example shows an error response to an AddImContactToGroup operation request. La réponse d’erreur suivante se produit lors d’une tentative d’ajout d’un contact qui n’est pas un contact de messagerie instantanée.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>

Le corps SOAP de la réponse d’erreur contient les éléments suivants :The error response SOAP body contains the following elements:

Voir aussiSee also