Operação AddNewImContactToGroup
Encontre informações sobre a operação AddNewImContactToGroup EWS.
A operação AddNewImContactToGroup adiciona um novo contato a um grupo de mensagens instantâneas (IM).
This operation was introduced in Exchange Server 2013.
Usando a operação AddNewImContactToGroup
A operação AddNewImContactToGroup usa os três argumentos a seguir para adicionar um novo contato a um grupo de IM:
Propriedade ImAddress – Identifica o endereço IM do contato. Esta propriedade é obrigatória.
Propriedade DisplayName – Identifica o nome de exibição do contato.
Propriedade GroupId – identifica o grupo ao qual o contato é adicionado.
Essa operação retorna a persona do contato que foi adicionado ao grupo.
Cabeçalhos SOAP da operação AddNewImContactToGroup
A operação AddNewImContactToGroup pode usar os cabeçalhos SOAP listados na tabela a seguir.
| Nome de cabeçalho | Elemento | Descrição |
|---|---|---|
| Representação |
ExchangeImpersonation |
Identifica o usuário que o aplicativo cliente está representando. Esse cabeçalho é aplicável a uma solicitação. |
| MailboxCulture |
MailboxCulture |
Identifica a cultura, conforme definido no RFC 3066, "Marcas para a Identificação de Idiomas", a ser usada para acessar a caixa de correio. Esse cabeçalho é aplicável a uma solicitação. |
| RequestVersion |
RequestServerVersion |
Identifica a versão do esquema para a solicitação de operação. Esse cabeçalho é aplicável a uma solicitação. |
| Serverversion |
ServerVersionInfo |
Identifica a versão do servidor que respondeu à solicitação. Esse cabeçalho é aplicável a uma resposta. |
Exemplo de solicitação de operação AddNewImContactToGroup: Adicionar um novo contato de IM a um grupo
O exemplo a seguir de uma solicitação de operação AddNewImContactToGroup mostra como adicionar um novo contato a um grupo de IM existente. O valor da propriedade GroupId para este exemplo foi retornado dos resultados da operação AddImGroup. A propriedade ExchangeStoreId contém o valor da propriedade GroupId .
<?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>
<t:TimeZoneContext>
<t:TimeZoneDefinition Id="GMT Standard Time"/>
</t:TimeZoneContext>
</soap:Header>
<soap:Body >
<m:AddNewImContactToGroup>
<m:ImAddress>tsmith@contoso.com</m:ImAddress>
<m:DisplayName>Tony Smith</m:DisplayName>
<m:GroupId Id="AAMkAGQ1MjJjMTBkLTc4Y2UtNDAAAQKAAA="
ChangeKey="EgAAAA=="/>
</m:AddNewImContactToGroup>
</soap:Body>
</soap:Envelope>
Observação
O valor GroupId foi encurtado para preservar a legibilidade.
O corpo SOAP de solicitação contém os seguintes elementos:
Resposta bem-sucedida da operação AddNewImContactToGroup
O exemplo a seguir mostra uma resposta bem-sucedida a uma solicitação de operação AddNewImContactToGroup . A resposta contém a persona do contato recém-criado. O contato é adicionado à pasta Contatos Rápidos no Exchange.
Observação
Os identificadores foram encurtados para preservar a legibilidade.
<?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="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"
xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types" />
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<AddNewImContactToGroupResponse ResponseClass="Success"
xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
<ResponseCode>NoError</ResponseCode>
<Persona>
<PersonaId Id="AAQkAGQ1MjJjMTBkLTc4Y2UtNDA5Ny04ZjU5LWI3MTYzNGNkZmRkYQAQAJ3EkhEEXN5KufGbSYJanZk="
xmlns="https://schemas.microsoft.com/exchange/services/2006/types" />
<PersonaType xmlns="https://schemas.microsoft.com/exchange/services/2006/types">Person</PersonaType>
<CreationTime xmlns="https://schemas.microsoft.com/exchange/services/2006/types">2012-01-05T23:06:58Z</CreationTime>
<DisplayName xmlns="https://schemas.microsoft.com/exchange/services/2006/types">Tony Smith</DisplayName>
<DisplayNameFirstLast xmlns="https://schemas.microsoft.com/exchange/services/2006/types">Tony Smith</DisplayNameFirstLast>
<DisplayNameLastFirst xmlns="https://schemas.microsoft.com/exchange/services/2006/types">Tony Smith</DisplayNameLastFirst>
<FileAsId xmlns="https://schemas.microsoft.com/exchange/services/2006/types">None</FileAsId>
<EmailAddress xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
<Name>Tony Smith</Name>
<Address>tsmith@contoso.com</Address>
<RoutingType>SMTP</RoutingType>
</EmailAddress>
<EmailAddresses xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
<EmailAddress>
<Name>Tony Smith</Name>
<Address>tsmith@contoso.com</Address>
<RoutingType>SMTP</RoutingType>
</EmailAddress>
</EmailAddresses>
<ImAddress xmlns="https://schemas.microsoft.com/exchange/services/2006/types">tsmith@contoso.com</ImAddress>
<RelevanceScore xmlns="https://schemas.microsoft.com/exchange/services/2006/types">2147483647</RelevanceScore>
<Attributions xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
<Attribution>
<Id>0</Id>
<SourceId Id="BtF8oI7iVOQatt/bhQoTbWAAAAAAvcAAA="
ChangeKey="EQAAABYAAABtF8oIQoTbWAAAAAAyg" />
<DisplayName>Outlook</DisplayName>
<IsWritable>true</IsWritable>
<IsQuickContact>true</IsQuickContact>
<IsHidden>false</IsHidden>
<FolderId Id="AAMkAGQ1MjJjMTBkLTc4YhQoTbWAAAAAAvZAAA="
ChangeKey="AQAAAA==" />
</Attribution>
</Attributions>
<DisplayNames xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
<StringAttributedValue>
<Value>Tony Smith</Value>
<Attributions>
<Attribution>0</Attribution>
</Attributions>
</StringAttributedValue>
</DisplayNames>
<FileAsIds xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
<StringAttributedValue>
<Value>None</Value>
<Attributions>
<Attribution>0</Attribution>
</Attributions>
</StringAttributedValue>
</FileAsIds>
<Emails1 xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
<EmailAddressAttributedValue>
<Value>
<Name>Tony Smith</Name>
<Address>tsmith@contoso.com</Address>
<RoutingType>SMTP</RoutingType>
</Value>
<Attributions>
<Attribution>0</Attribution>
</Attributions>
</EmailAddressAttributedValue>
</Emails1>
<ImAddresses xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
<StringAttributedValue>
<Value>tsmith@contoso.com</Value>
<Attributions>
<Attribution>0</Attribution>
</Attributions>
</StringAttributedValue>
</ImAddresses>
</Persona>
</AddNewImContactToGroupResponse>
</s:Body>
</s:Envelope>
O corpo SOAP de resposta contém os seguintes elementos:
Resposta de erro de operação AddNewImContactToGroup
O exemplo a seguir mostra uma resposta de erro a uma solicitação de operação AddNewImContactToGroup . Essa é uma resposta a uma solicitação para adicionar um contato a um grupo que não está na caixa de correio do solicitante.
<?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="578"
MinorBuildNumber="11"
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">
<AddNewImContactToGroupResponse ResponseClass="Error"
xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
<MessageText>No mailbox with such guid.</MessageText>
<ResponseCode>ErrorNonExistentMailbox</ResponseCode>
<DescriptiveLinkKey>0</DescriptiveLinkKey>
<MessageXml>
<t:Value Name="MailboxGuid" xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">d5fasdadcw3d-23de-2341-8f59-b71523fsddda</t:Value>
</MessageXml>
</AddNewImContactToGroupResponse>
</s:Body>
</s:Envelope>
O corpo SOAP de resposta de erro contém os seguintes elementos:
Para obter códigos de erro adicionais que são genéricos para o EWS e específicos para essa operação, consulte ResponseCode.
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de