Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
Тип разрешения
Разрешения с наименьшими привилегиями
Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись)
Коллекция идентификаторов для преобразования. Все идентификаторы в коллекции ДОЛЖНЫ иметь один и тот же тип исходного идентификатора и должны быть для элементов в одном почтовом ящике. Максимальный размер этой коллекции — 1000 строк.
sourceIdType
exchangeIdFormat
Тип идентификатора идентификаторов в параметре InputIds .
targetIdType
exchangeIdFormat
Запрошенный тип идентификатора для преобразования.
Двоичный формат неизменяемого идентификатора, совместимый с MAPI.
restId
Формат идентификатора по умолчанию, используемый Microsoft Graph.
restImmutableEntryId
Неизменяемый формат идентификатора, используемый Microsoft Graph.
Двоичные форматы (entryId и immutableEntryId) являются безопасными для URL-адресов в кодировке Base64. Безопасность URL-адресов реализуется путем изменения кодировки base64 двоичных данных следующим образом:
Заменить + на -
Заменить / на _
Удаление всех конечных символов с заполнением (=)
Добавьте целое число в конец строки, указывающее, сколько символов заполнений было в исходном (0, 1или 2).
Отклик
В случае успешного выполнения этот метод возвращает 200 OK код отклика и коллекцию convertIdResult в тексте отклика.
Пример
В следующем примере показано, как преобразовать несколько идентификаторов из обычного формата REST API (restId) в неизменяемый формат 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);
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.