如何通过 Graph API 创建带有清单项的 Planner Task

Question

我正在尝试创建一个包含几个清单项目的 Planner 任务。 清单项目是任务详细信息的一部分，但与描述字段不同，清单项目是具有唯一元素名称的项目列表，如下面的元素示例 14680 和 49286。

如何通过 API 为任务创建这样的列表？

"checklist": {
        "14680": {
            "@odata.type": "#microsoft.graph.plannerChecklistItem",
            "isChecked": true,
            "title": "Element 2",
            "orderHint": "8586819525[x",
            "lastModifiedBy": {
                "user": {
                    "displayName": null,
                    "id": "a275ad83-babe-437e-a62b-e4f4e738fd7b"
                }
            },
            "lastModifiedDateTime": "2018-02-26T14:11:40.2829359Z"
        },
        "49286": {
            "@odata.type": "#microsoft.graph.plannerChecklistItem",
            "isChecked": false,
            "title": "Element 1",
            "orderHint": "8586819526571539898P;",
            "lastModifiedBy": {
                "user": {
                    "displayName": null,
                    "id": "a275ad83-babe-437e-a62b-e4f4e738fd7b"
                }
            },
            "lastModifiedDateTime": "2018-02-26T14:11:28.3392169Z"
        }
    },

Answer 1

看起来你至少可以通过两个步骤来做到这一点：

• 首先创建任务，使用POST /planner/tasks （ 此处提供文档）

• 然后使用PATCH /planner/tasks/<id>/details ( doc ) 编辑创建的任务详细信息

这个最新的方法在它的主体中有一个checklist ，就像这个例子一样：

PATCH https://graph.microsoft.com/v1.0/planner/tasks/gcrYAaAkgU2EQUvpkNNXLGQAGTtu/details
Content-type: application/json
Content-length: 857
If-Match: W/"JzEtVGFzayAgQEBAQEBAQEBAQEBAQEBAWCc="

{
  "previewType": "noPreview",
  "references": {
    "http%3A//developer%2Emicrosoft%2Ecom":{
      "@odata.type": "microsoft.graph.plannerExternalReference",
      "alias": "Documentation",
      "previewPriority": " !",
      "type": "Other"
    },
    "https%3A//developer%2Emicrosoft%2Ecom/en-us/graph/graph-explorer":{
      "@odata.type": "microsoft.graph.plannerExternalReference",
      "previewPriority": "  !!",
    },
    "http%3A//www%2Ebing%2Ecom": null
  },
  "checklist": {
    "95e27074-6c4a-447a-aa24-9d718a0b86fa":{
      "@odata.type": "microsoft.graph.plannerChecklistItem",
      "title": "Update task details",
      "ischecked": true
    },
    "d280ed1a-9f6b-4f9c-a962-fb4d00dc50ff":{
      "@odata.type": "microsoft.graph.plannerChecklistItem",
      "isChecked": true,
    },
    "a93c93c5-10a6-4167-9551-8bafa09967a7": null
  }
}

如果您查看plannerChecklistItems文档，您将看到清单项目的 ID 是客户端生成的 ID：

开放类型的属性可以由客户端定义。 在这种情况下，客户端应提供 GUID 作为属性，并且它们的值必须是 checklistItem 对象。 示例如下所示。 要删除清单中的项目，请将属性的值设置为 null。

所以你必须生成你自己的 ID，你就完成了。