Outlook加载项REST调用错误

Question

我正在尝试使用Outlook Rest API标记（标记）消息，但我一直收到错误消息。 我尝试使用其他的Rest URL，但这无济于事-错误会有所不同。

我相信清单中允许这样做的重要值是：

<Requirements>
    <Sets>
      <Set Name="Mailbox" MinVersion="1.1" />
    </Sets>
  </Requirements>
...
<Permissions>ReadWriteItem</Permissions>
  <Rule xsi:type="RuleCollection" Mode="Or">
    <Rule xsi:type="ItemIs" ItemType="Message" FormType="Read" />
  </Rule>
...
<VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides" xsi:type="VersionOverridesV1_0">
    <Requirements>
      <bt:Sets DefaultMinVersion="1.3">
        <bt:Set Name="Mailbox" />
      </bt:Sets>
    </Requirements>

这是我要尝试导致错误的部分：

Office.context.mailbox.getCallbackTokenAsync({ isRest: true }, function (result)
{
    if (result.status === "succeeded")
    {
        var accessToken = result.value;
        var itemId = getItemRestId();
        var restUrl = Office.context.mailbox.restUrl + "/api/v2.0/messages/" + itemId;

        var request = {
            url: restUrl,
            type: "PATCH",
            dataType: 'json',
            data: { "Flag": { "FlagStatus": "Flagged" } },
            headers: { 
                "Authorization": "Bearer " + accessToken, 
                "Conntent-Type": "application/json" 
            }
        };

        $.ajax(request)
            .done(function (item)
            {
                // dome something
            })
            .fail(function (error)
            {
                // handle error
            });
    }
    else
    {
        // handle error
    }
});

function getItemRestId()
{
    if (Office.context.mailbox.diagnostics.hostName === 'OutlookIOS')
    {
        return Office.context.mailbox.item.itemId;
    }
    else
    {
        return Office.context.mailbox.convertToRestId(
            Office.context.mailbox.item.itemId,
            Office.MailboxEnums.RestVersion.Beta
        );
    }
}

上面的代码将导致错误：

{"readyState":4,"responseText":"","status":404,"statusText":"Not Found"}

如果我尝试JSON.stringify（）的请求的数据属性，我得到：

{"readyState":4,"responseText":"","status":404,"statusText":"Not Found"}

如果我将其余URL更改为（在较早的示例中看到）：

'https://outlook.office.com/api/beta/me/messages/'+ itemId;

以及请求的标头属性（在较早的示例中可见）：

headers: {
    'Authorization': 'Bearer ' + accessToken,
    'Content-Type': 'application/json'
}

然后我得到以下错误：

{
  "readyState": 4,
  "responseText": "{\"error\":{\"code\":\"ErrorAccessDenied\",\"message\":\"The api you are trying to access does not support item scoped OAuth.\"}}",
  "responseJSON": {
    "error": {
      "code": "ErrorAccessDenied",
      "message": "The api you are trying to access does not support item scoped OAuth."
    }
  },
  "status": 403,
  "statusText": "Forbidden"
}

有人可以在这里看到我做错了什么吗？

我正在Outlook 2016中调试，该帐户是Office 365。

更新：提琴手输出

这是我自己的示例发送的请求（结果为403 Forbidden） 完全错误： {“ error”：{“ code”：“ ErrorAccessDenied”，“ message”：“您尝试访问的api不支持项目范围内的OAuth。 “}}

PATCH https://outlook.office.com/api/beta/me/messages/AAMkAGNmMDllMTVhLTI3ZDctNDYxZS05ZWM5LTA3ZWQzMzYyNDBiOABGAAAAAAD6OQOAoKyKT6R02yYFe0bIBwD5fUzv7OgQQYAILztCFSSWAALg591rAAC382lxTQ2HQpUKZsAGTeWVAARPu37CAAA= HTTP/1.1
Content-Type: application/json
Accept: application/json, text/javascript, */*; q=0.01
Authorization: Bearer <long token code removed...>
Referer: https://localhost:44394/MessageRead.html?_host_Info=Outlook$Win32$16.02$da-DK
Accept-Language: da-DK
Origin: https://localhost:44394
Accept-Encoding: gzip, deflate
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; Trident/7.0; rv:11.0) like Gecko
Host: outlook.office.com
Content-Length: 33
Connection: Keep-Alive
Cache-Control: no-cache

{"Flag":{"FlagStatus":"Flagged"}}

这是演示项目发送的请求（结果为200 OK）

PATCH https://outlook.office.com/api/beta/me/messages/AAMkAGNmMDllMTVhLTI3ZDctNDYxZS05ZWM5LTA3ZWQzMzYyNDBiOABGAAAAAAD6OQOAoKyKT6R02yYFe0bIBwD5fUzv7OgQQYAILztCFSSWAALg591rAAC382lxTQ2HQpUKZsAGTeWVAARPu37CAAA= HTTP/1.1
Content-Type: application/json
Accept: application/json, text/javascript, */*; q=0.01
Authorization: Bearer <long token code removed...>
Referer: https://<company.domain.com>:1443/outlookaddindemo/RestCaller/RestCaller.html?_host_Info=Outlook$Win32$16.02$da-DK
Accept-Language: da-DK
Origin: https://<company.domain.com>:1443
Accept-Encoding: gzip, deflate
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; Trident/7.0; rv:11.0) like Gecko
Host: outlook.office.com
Content-Length: 47
Connection: Keep-Alive
Cache-Control: no-cache

{
  "Flag": {
    "FlagStatus": "Flagged"
  }
}

我可以看到的唯一区别是，第二个请求有效负载似乎已格式化以便读取，而数据方面与前一个完全相同。

我似乎在这里找不到问题-我什至确保两个项目都使用相同版本的JQuery。

Answer 1

如果需要通过REST对该项目进行写访问，则需要在清单的Permissions元素中指定ReadWriteMailbox 。 尽管名称如此， ReadWriteItem却没有为您提供具有适当范围的令牌。 除了ReadWriteMailbox以外的任何权限级别都提供一个项目范围的令牌，并且如错误所示，您尝试执行的操作不支持项目范围的OAuth。

有关详细信息，请参见https://docs.microsoft.com/zh-cn/outlook/add-ins/use-rest-api ，但这是相关的位：

加载项权限和令牌范围

重要的是要考虑您的加载项需要通过REST API进行什么级别的访问。 在大多数情况下，由getCallbackTokenAsync返回的令牌将仅提供对当前项目的只读访问。 即使您的外接程序在清单中指定了ReadWriteItem权限级别，也是如此。

如果您的加载项要求对用户邮箱中的当前项目或其他项目具有写访问权，则您的加载项必须在其清单中指定ReadWriteMailbox权限级别。 在这种情况下，返回的令牌将包含对用户的消息，事件和联系人的读/写访问权限。