Operação GetImItems
Encontre informações sobre a operação GetImItems EWS.
A operação GetImItems recupera informações sobre grupos de mensagens instantâneas (IM) e personas de contato de IM.
This operation was introduced in Exchange Server 2013.
Usando a operação GetImItems
A operação GetImItems aceita identificadores de itens de grupo e contato e retorna um conjunto de informações sobre os grupos e contatos. Os conjuntos de propriedades retornados na resposta são identificados por propriedades estendidas, vários identificadores de contato, identificadores de grupo e definições de propriedade estendidas como argumentos.
Cabeçalhos SOAP da operação GetImItems
A operação GetImItems 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 getImItems: obter informações detalhadas sobre contatos e grupos de IM
O exemplo a seguir de uma solicitação de operação GetImItems mostra como solicitar informações detalhadas sobre contatos e grupos de IM. Uma operação GetImItems pode solicitar um ou mais detalhes de contato ou grupo. Você também pode usar propriedades estendidas para obter propriedades personalizadas em grupos e contatos. Se uma propriedade estendida solicitada não existir em um item, a resposta ignorará a propriedade solicitada e retornará a resposta para o conjunto de propriedades padrão. Este exemplo mostra como obter o nome de exibição usando propriedades estendidas.
Observação
Todos os identificadores de item e chaves de alteração neste artigo foram encurtados para preservar a legibilidade. Observe que as chaves de alteração são ignoradas pelo serviço para essa operação.
<?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:GetImItems>
<m:ContactIds>
<t:ItemId Id="AAMkADEzOTExYACABmEhpSAAA=" ChangeKey="EQAAABBmNDjF"/>
</m:ContactIds>
<m:GroupIds>
<t:ItemId Id="AAMkADEzOTExYjJkBY7+0EAAA=" ChangeKey="EgAAAA=="/>
</m:GroupIds>
<m:ExtendedProperties>
<t:ExtendedProperty PropertyTag="0x3001" PropertyType="String"/>
</m:ExtendedProperties>
</m:GetImItems>
</soap:Body>
</soap:Envelope>
O corpo SOAP de solicitação contém os seguintes elementos:
Resposta bem-sucedida da operação GetImItems
O exemplo a seguir mostra uma resposta bem-sucedida a uma solicitação GetImItems para obter um contato e um grupo de IM. O nome de exibição é solicitado em uma propriedade estendida. Os contatos de IM são retornados na forma de uma persona.
<?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="556"
MinorBuildNumber="8"
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">
<GetImItemsResponse ResponseClass="Success"
xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
<ResponseCode>NoError</ResponseCode>
<ImItemList>
<Groups xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
<ImGroup>
<DisplayName>Exchange SDK Team</DisplayName>
<GroupType>IPM.DistList.MOC.UserGroup</GroupType>
<ExchangeStoreId Id="AAMkADEzQrAABY7+0EAAA=" ChangeKey="EgAAAA=="/>
<MemberCorrelationKey>
<ItemId Id="AAMkADEzOTExYjeGgGqm4QrAABmEhpSAAA=" ChangeKey="EQAAAA=="/>
</MemberCorrelationKey>
<ExtendedProperties>
<ExtendedProperty>
<ExtendedFieldURI PropertyTag="0x3001" PropertyType="String"/>
<Value>Exchange SDK Team</Value>
</ExtendedProperty>
</ExtendedProperties>
</ImGroup>
</Groups>
<Personas xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
<Persona>
<PersonaId Id="AAQkADEzOTBZImBzN5J/uHXc="/>
<PersonaType>Person</PersonaType>
<CreationTime>2012-11-07T00:10:35Z</CreationTime>
<DisplayName>Tony Smith</DisplayName>
<DisplayNameFirstLast>Tony Smith</DisplayNameFirstLast>
<DisplayNameLastFirst>Tony Smith</DisplayNameLastFirst>
<FileAs/>
<FileAsId>None</FileAsId>
<ImAddress>tsmith@contoso.com</ImAddress>
<RelevanceScore>2147483647</RelevanceScore>
<Attributions>
<Attribution>
<Id>0</Id>
<SourceId Id="AAMkADEzhQaoeGgGqm4QrAABmEhpSAAA=" ChangeKey="EQArAABmNDjF"/>
<DisplayName>Lync Contacts</DisplayName>
<IsWritable>false</IsWritable>
<IsQuickContact>true</IsQuickContact>
<IsHidden>false</IsHidden>
</Attribution>
</Attributions>
<DisplayNames>
<StringAttributedValue>
<Value>Tony Smith</Value>
<Attributions>
<Attribution>0</Attribution>
</Attributions>
</StringAttributedValue>
</DisplayNames>
<FileAsIds>
<StringAttributedValue>
<Value>None</Value>
<Attributions>
<Attribution>0</Attribution>
</Attributions>
</StringAttributedValue>
</FileAsIds>
<ImAddresses>
<StringAttributedValue>
<Value>tsmith@contoso.com</Value>
<Attributions>
<Attribution>0</Attribution>
</Attributions>
</StringAttributedValue>
</ImAddresses>
<ExtendedProperties>
<ExtendedPropertyAttributedValue>
<Value>
<ExtendedFieldURI PropertyTag="0x3001" PropertyType="String"/>
<Value>Tony Smith</Value>
</Value>
<Attributions>
<Attribution>0</Attribution>
</Attributions>
</ExtendedPropertyAttributedValue>
</ExtendedProperties>
</Persona>
</Personas>
</ImItemList>
</GetImItemsResponse>
</s:Body>
</s:Envelope>
O corpo SOAP de resposta contém os seguintes elementos:
FileAsId FileAsId
Resposta de erro da operação GetImItems
A operação GetImItems não valida identificadores e não retornará a resposta de erro ErrorInvalidImContactId ou ErrorInvalidImGroupId se um contato inválido ou identificador de grupo for fornecido ao serviço.
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