Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Traduzir os identificadores de recursos relacionados ao Outlook entre formatos.
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global | Governo dos EUA L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ✅ |
Permissões
As tabelas a seguir mostram a permissão ou permissões menos privilegiadas necessárias para chamar essa API em cada tipo de recurso com suporte. Siga as práticas recomendadas para solicitar permissões com privilégios mínimos. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
Permissões para traduzir IDs do Exchange para o usuário conectado:
POST /me/translateExchangeIds
| Tipo de permissão | Permissões menos privilegiadas | Permissões com privilégios mais elevados |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | User.ReadBasic.All | AgentIdUser.ReadWrite.All, AgentIdUser.ReadWrite.IdentityParentedBy, User.Read, User.Read.All, User.ReadWrite, User.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | User.Read | User.ReadWrite |
| Aplicativo | Sem suporte. | Sem suporte. |
Permissões para traduzir IDs do Exchange para um usuário:
POST /users/{id | userPrincipalName}/translateExchangeIds
| Tipo de permissão | Permissões menos privilegiadas | Permissões com privilégios mais elevados |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | User.ReadBasic.All | AgentIdUser.ReadWrite.All, AgentIdUser.ReadWrite.IdentityParentedBy, User.Read, User.Read.All, User.ReadWrite, User.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | User.Read | User.ReadWrite |
| Aplicativo | User.Read.All | AgentIdUser.ReadWrite.All, AgentIdUser.ReadWrite.IdentityParentedBy, User.ReadWrite.All |
Solicitação HTTP
Para converter IDs do Exchange para o usuário conectado usando permissões delegadas (/me):
POST /me/translateExchangeIds
Para converter IDs do Exchange usando permissões delegadas ou de aplicativo:
POST /users/{id | userPrincipalName}/translateExchangeIds
Cabeçalhos de solicitação
| Nome | Valor |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Corpo da solicitação
| Parâmetro | Tipo | Descrição |
|---|---|---|
| inputIds | String collection | Uma coleção de identificadores a serem convertidos. Todos os identificadores da coleção DEVEM ter o mesmo tipo de ID de origem e DEVEM ser para itens na mesma caixa de correio. O tamanho máximo desta coleção é de 1.000 cadeias de caracteres. |
| sourceIdType | exchangeIdFormat | O tipo de ID dos identificadores no inputIds parâmetro. |
| targetIdType | exchangeIdFormat | O tipo de ID solicitado para o qual converter. |
valores de exchangeIdFormat
| Member | Descrição |
|---|---|
| entryId | O formato de ID de entrada binária usado por clientes MAPI. |
| ewsId | O formato de ID usado pelos clientes de Serviços Web do Exchange. |
| immutableEntryId | O formato de ID imutável compatível com MAPI binário. |
| restId | O formato de ID padrão usado pelo Microsoft Graph. |
| restImmutableEntryId | O formato de ID imutável usado pelo Microsoft Graph. |
Os formatos binários (entryId e immutableEntryId) são seguros para URL, codificados em base64. A segurança de URL é implementada modificando a codificação base64 dos dados binários da seguinte maneira:
- Substituir
+por- - Substituir
/por_ - Remover todos os caracteres de preenchimento à direita (
=) - Adicione um inteiro ao final da cadeia de caracteres indicando quantos caracteres de preenchimento estavam no original (
0,1, ou2)
Resposta
Se for bem-sucedido, esse método retornará 200 OK um código de resposta e uma coleção convertIdResult no corpo da resposta.
Exemplo
O exemplo a seguir mostra como converter vários identificadores do formato normal da API REST (restId) para o formato imutável REST (restImmutableEntryId).
Solicitação
Aqui está a solicitação de exemplo.
POST https://graph.microsoft.com/beta/me/translateExchangeIds
Content-Type: application/json
{
"inputIds" : [
"{rest-formatted-id-1}",
"{rest-formatted-id-2}"
],
"sourceIdType": "restId",
"targetIdType": "restImmutableEntryId"
}
Resposta
Aqui está a resposta de exemplo
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
{
"sourceId": "{rest-formatted-id-1}",
"targetId": "{rest-immutable-formatted-id-1}"
},
{
"sourceId": "{rest-formatted-id-2}",
"targetId": "{rest-immutable-formatted-id-2}"
}
]
}