Partilhar via


usuário: translateExchangeIds

Namespace: microsoft.graph

Traduzir os identificadores de recursos relacionados ao Outlook entre formatos.

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Serviço global Governo dos EUA L4 GOVERNO DOS EUA L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. 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.

Tipo de permissão Permissões menos privilegiadas Permissões privilegiadas mais altas
Delegado (conta corporativa ou de estudante) User.ReadBasic.All User.Read, User.Read.All, User.ReadWrite, User.ReadWrite.All
Delegado (conta pessoal da Microsoft) User.Read User.ReadWrite
Aplicativo Sem suporte. Sem suporte.

Solicitação HTTP

POST /me/translateExchangeIds
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 dessa coleção é de 1000 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 exchangeIdFormat

Member Descrição
Entryid O formato de ID de entrada binária usado pelos clientes MAPI.
ewsId O formato de ID usado pelos clientes do Exchange Web Services.
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 codificados em base 64 com segurança de URL. A segurança da 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, 1ou 2)

Resposta

Se for bem-sucedido, esse método retornará 200 OK o 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 de API REST (restId) no formato imutável REST (restImmutableEntryId).

Solicitação

Aqui está a solicitação de exemplo.

POST https://graph.microsoft.com/v1.0/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}"
    }
  ]
}