MS Graph API...使用一個 HTTP 請求創建包含詳細信息/描述的 Planner 任務？

Question

我正在使用 Microsoft Graph API 創建 Planner 任務，我想知道是否有一種方法可以使用單個 HTTP 請求創建包括任務詳細信息/描述的任務。

這個 2018 年的老問題也在問同樣的事情。 2018 年的結果是需要幾個單獨的請求...首先創建任務，然后獲取和更新其詳細信息 object，這是一個有點繁瑣的過程。

最初的回答者最近更新了他們的回答，說這種行為已經改變，“您可以在創建任務的同一請求中設置任務詳細信息字段”。 但是，我很困惑這是否適用於 REST API 本身，或者適用於 Microsoft SDK（我目前沒有使用，因為我不需要它們的大部分功能）。

當我向 /planner/tasks 端點發出 POST 請求時，並在正文中提供詳細信息 object，就像這樣...

{
  "planId": "(... plan ID ...)",
  "bucketId": "(... bucket ID ...)",
  "title": "Title for new task",
  "details": {
    "description": "Some description for new task"
  },
  "assignments": {
       (... assignment data ...)
  }
}

...任務已創建，但我沒有看到任何描述/注釋。 這適用於“v1.0”和“beta”API。 （我也在測試版 API 上嘗試了較新的“notes”屬性，結果相同。）

根據MS 文檔，我也找不到決定性的答案。

像我列出的請求這樣的請求現在應該有效嗎？ 如果是，在哪個 API 版本中？ 如果沒有，我錯過了什么？

謝謝！

Answer 1

該請求應該有效，但對不包括任務詳細信息的創建操作的返回響應存在問題。 如果您在創建后閱讀任務詳細信息（或閱讀任務擴展詳細信息），則描述應該在那里。