Office.MailboxEnums.RestVersion enum

Пакет:

outlook

Указывает версию REST API, которая соответствует идентификатору элемента в формате REST.

Комментарии

[ Набор API: Почтовый ящик 1.3 ]

Применимый режим Outlook: Compose или чтение

Важно! Конечные точки REST Outlook версии 2.0 и бета-версии теперь устарели. Однако частные надстройки и надстройки, размещенные в AppSource, могут использовать службу REST до окончания расширенной поддержки Outlook 2019 14 октября 2025 г. Трафик из этих надстроек автоматически определяется для исключения. Это исключение также применяется к новым надстройкам, разработанным после 31 марта 2024 г. Хотя надстройки могут использовать службу REST до 2025 года, мы настоятельно рекомендуем перенести надстройки на использование Microsoft Graph. Рекомендации см. в статье Сравнение конечных точек REST API Microsoft Graph и Outlook.

Примеры

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/85-tokens-and-service-calls/ids-and-urls.yaml

// Get the EWS URL and EWS item ID.
console.log("EWS URL: " + Office.context.mailbox.ewsUrl);
const ewsId = Office.context.mailbox.item.itemId;
console.log("EWS item ID: " + Office.context.mailbox.item.itemId);

// Convert the EWS item ID to a REST-formatted ID.
const restId = Office.context.mailbox.convertToRestId(ewsId, Office.MailboxEnums.RestVersion.v2_0);
console.log("REST item ID: " + restId);

// Convert the REST-formatted ID back to an EWS-formatted ID.
const ewsId2 = Office.context.mailbox.convertToEwsId(restId, Office.MailboxEnums.RestVersion.v2_0);
console.log("EWS ID (from REST ID): " + ewsId2);

Поля

v1_0 = "v1.0"	Версия 1.0.
v2_0 = "v2.0"	Версия 2.0.
Beta = "beta"	Beta.