使用 Microsoft 图形 API上传教育作业和提交的文件

项目
11/07/2024

资源是教育作业和提交的一个组成部分。教师确定要上传到作业文件夹的资源，学生确定要上传到提交文件夹的资源。

本文介绍如何使用 Microsoft Graph 中的教育 API 将文件上传到作业或提交文件夹。

先决条件

在上传文件之前，请设置一个 SharePoint 文件夹，以便将给定教育作业或提交资源的文件上传到该文件夹。

上传资源

API setUpResourcesFolder 返回包含 resourcesFolderUrl 属性的模型。

{
    ...
    "resourcesFolderUrl": "https://graph.microsoft.com/v1.0/drives/b!6SQl0y4WHkS2P5MeIsSGpKwfynEIaD1OvPVeH4wbOp_1uyhNwJMSSpseJneB7Z4F/items/01YT2AIJRQLVYT24IWWFAJHMRRNYCB3GFA"
    ...
}

以下步骤介绍如何将资源/文件上传到相关资源文件夹。

步骤 1 - 构造上传 URL

生成 URL 以按照此特定格式 {resourcesFolderUrl}:/{Name of new file}:/content上传内容。以下示例演示包含 resourcesFolderUrl 属性的上传 URL。

https://graph.microsoft.com/v1.0/drives/b!6SQl0y4WHkS2P5MeIsSGpKwfynEIaD1OvPVeH4wbOp_1uyhNwJMSSpseJneB7Z4F/items/01YT2AIJRQLVYT24IWWFAJHMRRNYCB3GE2:/MyPictureFile.png:/content

步骤 2 - 将资源上传到 SharePoint

使用上传 URL 发出 PUT 请求以上传内容。

请求正文的内容应该是要上载文件的二进制流。

有关详细信息，请参阅使用上传会话上传大型文件。

请求

下面为请求示例。

PUT https://graph.microsoft.com/v1.0/drives/b!6SQl0y4WHkS2P5MeIsSGpKwfynEIaD1OvPVeH4wbOp_1uyhNwJMSSpseJneB7Z4F/items/01YT2AIJRQLVYT24IWWFAJHMRRNYCB3GE2:/MyPictureFile.png:/content
Content-Type: text/plain

Binary data for the file

响应

以下示例显示了相应的响应。

HTTP/1.1 201 Created
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#drives('b%216SQl0y4WHkS2P5MeIsSGpKwfynEIaD1OvPVeH4wbOp_1uyhNwJMSSpseJneB7Z4F')/items/$entity",
    "@microsoft.graph.downloadUrl": "...",
    "createdDateTime": "2021-03-11T18:49:47Z",
    "eTag": "\"{EDD00CE7-B74C-4C3E-BA3E-484CB41EF31D},1\"",
    "id": "01YT2AIJU7DAXTU6XLOJGYWYMTGM5JT5UQ",
    "lastModifiedDateTime": "2021-03-11T18:49:47Z",
    "name": "MyPictureFile.png",
    "webUrl": "https://contososdorg.sharepoint.com/sites/GraphTest/Class%20Files/Assignments/Test%20File%20Distribution/MyPictureFile.png",
    "cTag": "\"c:{EDD00CE7-B74C-4C3E-BA3E-484CB41EF31D},2\"",
    "size": 2302233,
    "createdBy": {
        "application": null,
        "device": null,
        "user": {
            "email": "t-james@contososd.org",
            "id": "42ff222c-571f-497c-a9d3-f77ea9ece327",
            "displayName": "James"
        }
    },
    "lastModifiedBy": {
        "application": null,
        "device": null,
        "user": {
            "email": "t-james@contososd.org",
            "id": "42ff222c-571f-497c-a9d3-f77ea9ece327",
            "displayName": "James"
        }
    },
    "parentReference": {
        "driveId": "b!6SQl0y4WHkS2P5MeIsSGpKwfynEIaD1OvPVeH4wbOp_1uyhNwJMSSpseJneB7Z4F",
        "driveType": "documentLibrary",
        "id": "01YT2AIJRQLVYT24IWWFAJHMRRNYCB3GE2",
        "path": "/drives/b!6SQl0y4WHkS2P5MeIsSGpKwfynEIaD1OvPVeH4wbOp_1uyhNwJMSSpseJneB7Z4F/root:/Assignments/Test File Distribution"
    },
    "file": {
        "mimeType": "image/png",
        "hashes": {
            "quickXorHash": "CvYQxN7MCGrIsdrA38c6wWhOu5g="
        }
    },
    "fileSystemInfo": {
        "createdDateTime": "2021-03-11T18:49:47Z",
        "lastModifiedDateTime": "2021-03-11T18:49:47Z"
    },
    "image": {}
}

步骤 3 - 构造 fileUrl 属性的值

使用以下格式生成 fileUrl 属性的值： https://graph.microsoft.com/v1.0/drives/{drive-id}/items/{item-id}。 {drive-id}将和 {item-id} 占位符替换为下表中所述的值。

占位符	说明	示例
`{drive-id}`	步骤 2 中使用的请求 URL 中的驱动器 ID。	b！6SQl0y4WHkS2P5MeIsSGpKwfynEIaD1OvPVeH4wbOp_1uyhNwJMSSpseJneB7Z4F
`{item-id}`	步骤 2 中获取的响应正文中的项 ID。	01YT2AIJU7DAXTU6XLOJGYWYMTGM5JT5UQ

以下示例演示基于此格式 的 fileUrl 。

https://graph.microsoft.com/v1.0/drives/b!6SQl0y4WHkS2P5MeIsSGpKwfynEIaD1OvPVeH4wbOp_1uyhNwJMSSpseJneB7Z4F/items/01YT2AIJU7DAXTU6XLOJGYWYMTGM5JT5UQ

步骤 4 - 创建 educationAssignmentResource

此步骤演示如何将 SharePoint 资源上传到工作分配资源文件夹。

fileUrl使用请求正文中上一步中的创建 educationAssignmentResource。

请求