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.
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).
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Me.TranslateExchangeIds;
using Microsoft.Graph.Models;
var requestBody = new TranslateExchangeIdsPostRequestBody
{
InputIds = new List<string>
{
"{rest-formatted-id-1}",
"{rest-formatted-id-2}",
},
SourceIdType = ExchangeIdFormat.RestId,
TargetIdType = ExchangeIdFormat.RestImmutableEntryId,
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Me.TranslateExchangeIds.PostAsTranslateExchangeIdsPostResponseAsync(requestBody);
// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc users translate-exchange-ids post --user-id {user-id} --body '{\
"inputIds" : [\
"{rest-formatted-id-1}",\
"{rest-formatted-id-2}"\
],\
"sourceIdType": "restId",\
"targetIdType": "restImmutableEntryId"\
}\
'
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
com.microsoft.graph.users.item.translateexchangeids.TranslateExchangeIdsPostRequestBody translateExchangeIdsPostRequestBody = new com.microsoft.graph.users.item.translateexchangeids.TranslateExchangeIdsPostRequestBody();
LinkedList<String> inputIds = new LinkedList<String>();
inputIds.add("{rest-formatted-id-1}");
inputIds.add("{rest-formatted-id-2}");
translateExchangeIdsPostRequestBody.setInputIds(inputIds);
translateExchangeIdsPostRequestBody.setSourceIdType(ExchangeIdFormat.RestId);
translateExchangeIdsPostRequestBody.setTargetIdType(ExchangeIdFormat.RestImmutableEntryId);
var result = graphClient.me().translateExchangeIds().post(translateExchangeIdsPostRequestBody);
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.