Microsoft 365 Developer Blog
·
在Shifts管理Microsoft Graph API中弃用MS-APP-ACTS-AS头部
内容提要
在应用程序仅访问场景中，Shifts管理图API已弃用MS-APP-ACTS-AS头部。请移除该头部，并使用新的API格式，确保请求体中包含用户ID。更改涉及批准、拒绝请求及时间卡的处理方式。
关键要点
-
在应用程序仅访问场景中，Shifts管理图API已弃用MS-APP-ACTS-AS头部。
-
如果当前不发送MS-APP-ACTS-AS头部，则无需进行更改。
-
如果当前发送MS-APP-ACTS-AS头部，请移除该头部，并在请求体中包含用户ID。
-
对于时间变更请求，使用/approveForUser和/declineForUser替代/approve和/decline。
-
创建时间请假请求时，需通过senderUserId属性提供发送者用户ID。
-
确认时间卡时，使用/confirmForUser替代/confirm。
-
打卡时间卡时，需通过onBehalfOfUserId属性提供打卡用户的ID。
-
创建时间卡时，需通过userId属性提供时间卡拥有者的ID。
延伸解读
API变更的背景
MS-APP-ACTS-AS头部的弃用是为了与Microsoft Graph的权限模型保持一致。在应用程序仅访问场景中，之前需要该头部来指明用户身份，但在没有登录用户的情况下，这种做法显得不合适。
实施新API的注意事项
开发者在移除MS-APP-ACTS-AS头部后，需确保在请求体中包含用户ID。特别是在处理时间变更请求和时间卡时，使用新的API格式是必要的，以避免请求失败或数据错误。
对现有应用的影响
如果当前应用未使用MS-APP-ACTS-AS头部，则无需进行任何更改。但如果正在使用，开发者必须及时更新代码，以确保应用的正常运行和兼容性。
延伸问答
Shifts管理图API中弃用MS-APP-ACTS-AS头部的原因是什么？
MS-APP-ACTS-AS头部的弃用是为了与Microsoft Graph的权限模型保持一致，因为在应用程序仅访问场景中没有登录用户。
如果我当前发送MS-APP-ACTS-AS头部，应该如何处理？
如果当前发送MS-APP-ACTS-AS头部，请将其移除，并在请求体中包含用户ID。
如何使用新的API格式处理时间变更请求？
对于时间变更请求，使用/approveForUser和/declineForUser替代/approve和/decline。
创建时间请假请求时需要提供哪些信息？
创建时间请假请求时，需要通过senderUserId属性提供发送者用户ID。
如何确认时间卡？
确认时间卡时，请使用/confirmForUser替代/confirm，并在请求中包含用户ID。
打卡时间卡时需要提供什么信息？
打卡时间卡时，需要通过onBehalfOfUserId属性提供打卡用户的ID。
