Office.MailboxEnums.RestVersion enum

包:

outlook

指定对应于 REST 格式的项目 ID 的 REST API 的版本。

注解

[ API 集：邮箱 1.3 ]

适用的 Outlook 模式：Compose或读取

重要提示：Outlook REST v2.0 和 beta 终结点现已弃用。 但是，在 2025 年 10 月 14 日 Outlook 2019 的扩展支持结束之前，私下发布的加载项和 AppSource 托管的加载项可以使用 REST 服务。 将自动标识来自这些加载项的流量以免除。 此豁免也适用于 2024 年 3 月 31 日之后开发的新加载项。 尽管加载项能够在 2025 年之前使用 REST 服务，但我们强烈建议你迁移加载项以使用 Microsoft Graph。 有关指导，请参阅 比较 Microsoft Graph 和 Outlook REST API 终结点。

示例

// 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.