baseTask：移动已弃用 ()

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

警告

2022 年 5 月 31 日， 基于 baseTask 构建的未完成 API 集已弃用，2022 年 8 月 31 日停止返回数据。 请改用 todoTask API。

将 baseTask 对象从一个 baseTaskList 移到另一个 baseTaskList 。

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时，才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息，请参阅权限类型。 要了解有关这些权限的详细信息，请参阅 权限参考。

权限类型	最低特权权限	更高特权权限
委派（工作或学校帐户）	Tasks.ReadWrite	不可用。
委派（个人 Microsoft 帐户）	Tasks.ReadWrite	不可用。
应用程序	不支持。	不支持。

HTTP 请求

POST /me/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}/move
POST /users/{userId|userPrincipalName}/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}/move

POST /me/tasks/alltasks/{baseTaskId}/move
POST /users/{userId|userPrincipalName}/tasks/alltasks/{baseTaskId}/move

可选的查询参数

此方法支持一些 OData 查询参数来帮助自定义响应。 若要了解一般信息，请参阅 OData 查询参数。

请求标头

名称	说明
Authorization	持有者 {token}。 必填。 详细了解 身份验证和授权。

请求正文

在请求正文中，提供参数的 JSON 表示形式。

下表显示了可用于此操作的参数。

参数	类型	说明
destinationTaskListId	String	baseTask 对象必须移动到的 baseTaskList。

响应

如果成功，此操作将在 200 OK 响应正文中返回响应代码和 baseTask 。

示例

请求

HTTP

POST https://graph.microsoft.com/beta/me/tasks/lists/AAMkAGVjMzJmMWZjLTgyYjgtNGIyNi1hOGQ0LWRjMjNmMGRmOWNiYQAuAAAAAAAboFsPFj7gQpLAt/tasks/AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AkOO4xOT/move
Content-Type: application/json
Content-length: 41

{
  "destinationTaskListId": "AAMkAGVjMzJmMWZjLTgyYjgtNGIyNi1hOGQ0LWRjMjNmMGRmOWNiYQAuAAAAAAAboFsPFj7gQqFxG"
}

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const move = {
  destinationTaskListId: 'AAMkAGVjMzJmMWZjLTgyYjgtNGIyNi1hOGQ0LWRjMjNmMGRmOWNiYQAuAAAAAAAboFsPFj7gQqFxG'
};

await client.api('/me/tasks/lists/AAMkAGVjMzJmMWZjLTgyYjgtNGIyNi1hOGQ0LWRjMjNmMGRmOWNiYQAuAAAAAAAboFsPFj7gQpLAt/tasks/AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AkOO4xOT/move')
	.version('beta')
	.post(move);

重要

Microsoft Graph SDK 默认使用 v1.0 版本的 API，并且不支持 beta 版本中提供的所有类型、属性和 API。 有关使用 SDK 访问 beta API 的详细信息，请参阅将 Microsoft Graph SDK 与 beta API 配合使用。

有关如何将 SDK 添加到项目并 创建 authProvider 实例的详细信息，请参阅 SDK 文档。

响应

注意：为了提高可读性，可能缩短了此处显示的响应对象。

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.type": "#microsoft.graph.task",
    "@odata.etag": "W/\"kOO4xOT//0qFRAqk3TNe0QAAAymRCA==\"",
    "importance": "normal",
    "status": "notStarted",
    "displayName": "T1",
    "createdDateTime": "2021-11-15T13:16:53.0831814Z",
    "lastModifiedDateTime": "2021-11-15T13:17:24.9876101Z",
    "id": "AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AkOO4xOT",
    "body": {
        "content": "",
        "contentType": "text"
    },
    "parentList": {
        "id": "AAMkAGVjMzJmMWZjLTgyYjgtNGIyNi1hOGQ0LWRjMjNmMGRmOWNiYQAuAAAAAAAboFsPFj7gQqFxG"
    }
}