baseTask の更新 (非推奨)
名前空間: microsoft.graph
重要
Microsoft Graph の /beta
バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
注意
baseTask 上に構築された To Do API セットは、2022 年 5 月 31 日に非推奨となり、2022 年 8 月 31 日にデータの返しを停止しました。 代わりに todoTask API を使用してください。
baseTask オブジェクトのプロパティを更新します。
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
---|---|---|
委任 (職場または学校のアカウント) | Tasks.ReadWrite | 注意事項なし。 |
委任 (個人用 Microsoft アカウント) | Tasks.ReadWrite | 注意事項なし。 |
アプリケーション | サポートされていません。 | サポートされていません。 |
HTTP 要求
PATCH /me/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}
PATCH /users/{userId|userPrincipalName}/tasks/lists/{baseTaskListId}/tasks/{baseTaskId}
PATCH /me/tasks/alltasks/{baseTaskId}
PATCH /users/{userId|userPrincipalName}/tasks/alltasks/{baseTaskId}
要求ヘッダー
名前 | 説明 |
---|---|
Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
要求本文
要求本文で、更新すべきプロパティの値のみを指定します。 要求本文に含まれていない既存のプロパティは、以前の値を維持するか、他のプロパティ値の変更に基づいて再計算されます。
次の表に、更新できるプロパティを示します。
プロパティ | 型 | 説明 |
---|---|---|
textBody | String | 通常、タスクに関する情報を含むテキスト形式のタスク本文。 |
createdDateTime | DateTimeOffset | タスクが終了した日付 (指定のタイム ゾーン)。 |
lastModifiedDateTime | DateTimeOffset | タスクが最後に変更された日時。 既定では、UTC 時間です。 要求ヘッダーでカスタム タイム ゾーンを使用できます。 |
bodyLastModifiedDateTime | DateTimeOffset | タスク本文が最後に変更された日時。 既定では、UTC 時間です。 要求ヘッダーでカスタム タイム ゾーンを使用できます。 |
CompletedDateTime | DateTimeOffset | タスクが終了した日付 (指定のタイム ゾーン)。 |
dueDateTime | dateTimeTimeZone | タスクが終了する予定の日時 (指定のタイム ゾーン)。 |
startDateTime | dateTimeTimeZone | タスクを開始する日付 (指定のタイム ゾーン)。 |
importance | 重要度 | イベントの重要度。 使用可能な値: low 、normal 、high 。 |
recurrence | patternedRecurrence | タスクの繰り返しパターン。 |
displayName | String | タスクの簡単な説明。 |
status | taskStatus_v2 | タスクの状態または進行状況を示します。 使用可能な値: notStarted 、inProgress 、completed 、unknownFutureValue 。 |
見方 | taskViewpoint | reminderDateTime などのユーザーに個人用のプロパティ。 |
応答
成功した場合、このメソッドは応答コード 200 OK
と、応答本文で更新された baseTask オブジェクトを返します。
例
要求
PATCH https://graph.microsoft.com/beta/me/tasks/lists/AAMkAGVjMzJmMWZjLTgyYjgtNGIyNi1hOGQ0LWRjMjNmMGRmOWNiYQAuAAAAAAAboFsPFj7gQpLAt/tasks/AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AkOO4xOT
Content-Type: application/json
Content-length: 634
{
"@odata.type": "#microsoft.graph.task",
"textBody": "String",
"bodyLastModifiedDateTime": "String (timestamp)",
"completedDateTime": "String (timestamp)",
"dueDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"startDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"importance": "String",
"recurrence": {
"@odata.type": "microsoft.graph.patternedRecurrence"
},
"displayName": "String",
"status": "String",
"viewpoint": {
"@odata.type": "microsoft.graph.taskViewpoint"
}
}
応答
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.task",
"@odata.etag": "W/\"kOO4xOT//0qFRAqk3TNe0QAAA1uzSQ==\"",
"importance": "normal",
"status": "notStarted",
"displayName": "T-2",
"createdDateTime": "2021-11-15T14:38:25.6868632Z",
"lastModifiedDateTime": "2021-11-15T15:51:13.3606631Z",
"id": "AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AkOO4xOT",
"textBody": "",
"parentList": {
"id": "AAMkAGVjMzJmMWZjLTgyYjgtNGIyNi1hOGQ0LWRjMjNmMGRmOWNiYQAuAAAAAAAboFsPFj7gQpLAt"
}
}