Outlook iOS/Android插件如何替代ewsUrl实现邮件附件获取？

阿华AIGC实验室

2026-5-25

解决方案：移动端Outlook插件获取邮件附件

针对你遇到的移动端Outlook不支持ewsUrl的问题，这里有两个可靠的跨平台方案，帮你实现附件获取：

方案1：使用Office.js内置的附件集合与API

Office.js提供了全平台兼容的Office.context.mailbox.item.attachments集合，搭配getAttachmentContentAsync方法，这是最直接的移动端适配方案。

实现步骤：

遍历当前邮件的attachments集合，筛选出目标附件对象
调用getAttachmentContentAsync获取附件内容，支持base64、文本等多种格式

代码示例：

// 遍历邮件中的所有附件
Office.context.mailbox.item.attachments.forEach(function(attachment) {
  // 跳过内嵌附件（比如邮件里的图片），只处理普通附件
  if (!attachment.isInline) {
    // 根据附件ID获取内容
    Office.context.mailbox.item.getAttachmentContentAsync(attachment.id, { asyncContext: attachment },
      function(result) {
        if (result.status === Office.AsyncResultStatus.Succeeded) {
          var content = result.value;
          // 根据附件格式做对应处理
          switch (content.format) {
            case Office.MailboxEnums.AttachmentContentFormat.Base64:
              // 处理base64编码的文件内容（比如图片、文档）
              console.log("Base64格式附件内容:", content.content);
              break;
            case Office.MailboxEnums.AttachmentContentFormat.Text:
              // 处理纯文本附件
              console.log("文本格式附件内容:", content.content);
              break;
            // 其他格式按需扩展
          }
        } else {
          console.error("获取附件失败:", result.error.message);
        }
      }
    );
  }
});

方案2：调用Microsoft Graph API

如果需要更复杂的附件操作（比如批量获取附件元数据、下载大附件等），可以通过获取Graph访问令牌，调用Graph API的邮件附件端点。

实现步骤：

获取当前邮件的itemId（移动端完全支持该属性）
调用getCallbackTokenAsync获取兼容Graph的访问令牌
使用令牌调用Graph API的/me/messages/{messageId}/attachments端点获取附件详情

代码示例：

// 获取当前邮件的ID
const messageId = Office.context.mailbox.item.itemId;

// 获取Graph访问令牌
Office.context.mailbox.getCallbackTokenAsync({ isRest: true }, function(tokenResult) {
  if (tokenResult.status === Office.AsyncResultStatus.Succeeded) {
    const accessToken = tokenResult.value;
    // 调用Graph API获取附件列表
    fetch(`https://graph.microsoft.com/v1.0/me/messages/${messageId}/attachments`, {
      headers: {
        "Authorization": `Bearer ${accessToken}`
      }
    })
    .then(response => response.json())
    .then(data => {
      // 遍历处理每个附件
      data.value.forEach(attachment => {
        console.log("附件名称:", attachment.name);
        console.log("附件大小:", attachment.size);
        // 若需获取附件内容，可调用 /attachments/{attachmentId}/content 端点
      });
    })
    .catch(error => console.error("调用Graph API失败:", error));
  } else {
    console.error("获取访问令牌失败:", tokenResult.error.message);
  }
});