todoTask を更新する
名前空間: microsoft.graph
重要
Microsoft Graph の /beta
バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
todoTask オブジェクトのプロパティを更新します。
この API は、次の国内クラウド展開で使用できます。
グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください。
アクセス許可の種類 | 最小特権アクセス許可 | 特権の高いアクセス許可 |
---|---|---|
委任 (職場または学校のアカウント) | Tasks.ReadWrite | 注意事項なし。 |
委任 (個人用 Microsoft アカウント) | Tasks.ReadWrite | 注意事項なし。 |
アプリケーション | サポートされていません。 | サポートされていません。 |
HTTP 要求
PATCH /me/todo/lists/{todoTaskListId}/tasks/{taskId}
PATCH /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{taskId}
要求ヘッダー
名前 | 説明 |
---|---|
Authorization | ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。 |
Content-Type | application/json. 必須です。 |
要求本文
要求本文で、 todoTask オブジェクトの JSON 表現を指定します。
次の表に、 todoTask を作成するときに必要なプロパティを示します。
プロパティ | 型 | 説明 |
---|---|---|
id | String | タスクの一意識別子。 エンティティから継承 |
body | itemBody | 通常はタスクに関する情報を含むタスク本体。 HTML 型のみがサポートされていることに注意してください。 |
categories | String コレクション | タスクに関連付けられたカテゴリ。 各カテゴリは、ユーザーが定義した outlookCategory の displayName プロパティに対応しています。 |
completedDateTime | dateTimeTimeZone | タスクが終了した日付 (指定のタイム ゾーン)。 |
dueDateTime | dateTimeTimeZone | タスクが終了する予定の日時 (指定のタイム ゾーン)。 |
importance | 重要度 | イベントの重要度。 可能な値は、low 、normal 、high です。 |
isReminderOn | Boolean | ユーザーにタスクを通知するアラートを設定する場合は、true に設定します。 |
recurrence | patternedRecurrence | タスクの繰り返しパターン。 |
reminderDateTime | dateTimeTimeZone | タスクのアラーム通知を行う日時。 |
startDateTime | dateTimeTimeZone | タスクの開始がスケジュールされている、指定したタイム ゾーン内の日付。 |
status | taskStatus | タスクの状態または進行状況を示します。 可能な値は、notStarted 、inProgress 、completed 、waitingOnOthers 、deferred です。 |
title | String | タスクの簡単な説明。 |
createdDateTime | DateTimeOffset | タスクが作成された日時。 既定では、UTC 時間です。 要求ヘッダーでカスタム タイム ゾーンを使用できます。 |
lastModifiedDateTime | DateTimeOffset | タスクが最後に変更された日時。 既定では、UTC 時間です。 要求ヘッダーでカスタム タイム ゾーンを使用できます。 |
bodyLastModifiedDateTime | DateTimeOffset | タスク本文が最後に変更された日時。 既定では、UTC 時間です。 要求ヘッダーでカスタム タイム ゾーンを使用できます。 |
応答
成功した場合、このメソッドは 200 OK
応答コードと、応答本文で更新された todoTask オブジェクトを返します。
例
要求
PATCH https://graph.microsoft.com/beta/me/todo/lists/AAMkADA1MTHgwAAA=/tasks/721a35e2-35e2-721a-e235-1a72e2351a72
Content-Type: application/json
{
"dueDateTime":{
"dateTime":"2020-07-25T16:00:00",
"timeZone":"Eastern Standard Time"
}
}
応答
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#tasks/$entity",
"@odata.etag": "W/\"s8/ERWT3WEeFpBGD0bDgAA+TWq9g==\"",
"importance": "low",
"isReminderOn": false,
"status": "notStarted",
"title": "Shop for dinner",
"createdDateTime": "2020-07-22T10:39:03.7937971Z",
"lastModifiedDateTime": "2020-07-22T12:02:10.8835421Z",
"categories": [],
"id": "721a35e2-35e2-721a-e235-1a72e2351a72",
"body": {
"content": "",
"contentType": "text"
},
"dueDateTime": {
"dateTime": "2020-08-25T04:00:00.0000000",
"timeZone": "UTC"
}
}
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示