名前空間: microsoft.graph
todoTask は、作業や個人用アイテムなど、追跡して完了できるタスクを表します。
todoTaskは常にtodoTaskListに含まれています。 これには、 linkedResource オブジェクトのコレクションに対するリレーションシップが含まれており、タスクの 1 つ以上のソースを追跡します。
このリソースでは、以下がサポートされています。
- Open Extensions でカスタム プロパティとしてデータを追加します。
- 差分クエリを使用して、増分の追加、削除、更新を追跡します。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| List tasks | todoTask コレクション | 指定されたリスト内のすべての todoTask リソースを取得します。 |
| Create task | todoTask | 指定したタスク リストに todoTask を作成する |
| タスクを取得する | todoTask | todoTask オブジェクトのプロパティと関係を読み取ります。 |
| タスクを更新する | todoTask | todoTask オブジェクトのプロパティを更新します。 |
| タスクを削除する | なし | todoTask オブジェクトを削除します。 |
| checklistItems を一覧表示する | チェックリストアイテム コレクション | checklistItems ナビゲーション プロパティから checklistItem リソースを取得します。 |
| checklistItem を作成する | checklistItem | 新しい checklistItem オブジェクトを作成します。 |
| linkedResources を一覧表示する | linkedResource コレクション | linkedResources ナビゲーション プロパティから linkedResources を取得します。 |
| linkedResources を作成する | linkedResource | 新しい linkedResources オブジェクトを作成します。 |
| 拡張プロパティ | ||
| 単一値のプロパティを作成する | todoTask | 新規または既存の todoTask オブジェクトに 1 つ以上の単一値拡張プロパティを作成します。 |
| 単一値のプロパティを取得する | todoTask |
$expand または $filter を使用して、単一値の拡張プロパティが含まれる todoTask オブジェクトを取得します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| body | itemBody | 通常はタスクに関する情報を含むタスク本体。 |
| bodyLastModifiedDateTime | DateTimeOffset | タスク本文が最後に変更された日時。 既定では、UTC 時間です。 要求ヘッダーでカスタム タイム ゾーンを使用できます。 プロパティの値は、ISO 8601 形式を使って表され、常に UTC 時間です。 たとえば、2020 年 1 月 1 日の午前 0 時の UTC は、'2020-01-01T00:00:00Z' のようになります。 |
| categories | String コレクション | タスクに関連付けられたカテゴリ。 各カテゴリは、ユーザーが定義した outlookCategory の displayName プロパティに対応しています。 |
| completedDateTime | dateTimeTimeZone | タスクが完了した、指定されたタイム ゾーンの日時。 |
| createdDateTime | DateTimeOffset | タスクが作成された日時。 既定では、UTC 時間です。 要求ヘッダーでカスタム タイム ゾーンを使用できます。 プロパティの値は、ISO 8601 形式を使用します。 たとえば、2020 年 1 月 1 日の午前 0 時の UTC は、'2020-01-01T00:00:00Z' のようになります。 |
| dueDateTime | dateTimeTimeZone | タスクを終了する指定されたタイム ゾーンの日付と時刻。 |
| hasAttachments | ブール値 | タスクに添付ファイルがあるかどうかを示します。 |
| id | String | タスクの一意識別子。 既定では、アイテムがリスト間で移動すると、この値が変更されます。 |
| importance | importance | タスクの重要性。 使用可能な値: low、normal、high。 |
| isReminderOn | Boolean | ユーザーにタスクを通知するアラートを設定する場合は、true に設定します。 |
| lastModifiedDateTime | DateTimeOffset | タスクが最後に変更された日時。 既定では、UTC 時間です。 要求ヘッダーでカスタム タイム ゾーンを使用できます。 プロパティの値は、ISO 8601 形式を使って表され、常に UTC 時間です。 たとえば、2020 年 1 月 1 日の午前 0 時の UTC は、'2020-01-01T00:00:00Z' のようになります。 |
| recurrence | patternedRecurrence | タスクの繰り返しパターン。 |
| reminderDateTime | dateTimeTimeZone | タスクのリマインダー アラートが発生する、指定されたタイム ゾーンの日付と時刻。 |
| startDateTime | dateTimeTimeZone | タスクの開始がスケジュールされた、指定したタイム ゾーンの日時。 |
| status | taskStatus | タスクの状態または進行状況を示します。 使用可能な値: notStarted、inProgress、completed、waitingOnOthers、deferred。 |
| title | String | タスクの簡単な説明。 |
タスクは、「 Microsoft Purview ポータルからコンテンツ検索結果をエクスポートする」で説明されている PST ダウンロードを使用してエクスポートできます。 To Do API の概要で、todoTaskプロパティとエクスポートされた PST ファイル内のプロパティとのマッピングを参照できます。
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| attachments | taskFileAttachment コレクション | タスクの添付ファイルのコレクション。 |
| checklistItems | チェックリストアイテム コレクション | タスクにリンクされている checklistItems のコレクション。 |
| extensions | extension コレクション | タスクに定義されているオープン拡張機能のコレクション。 Null 許容型です。 |
| linkedResources | linkedResource コレクション | タスクにリンクされたリソースのコレクション。 |
| singleValueExtendedProperties | singleValueExtendedProperty コレクション | タスクにリンクされたカスタム フィールドのコレクション。 |
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.todoTask",
"id": "String (identifier)",
"body": {
"@odata.type": "microsoft.graph.itemBody"
},
"categories": ["string"],
"completedDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"dueDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"importance": "String",
"isReminderOn": "Boolean",
"recurrence": {
"@odata.type": "microsoft.graph.patternedRecurrence"
},
"reminderDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"status": "String",
"title": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"bodyLastModifiedDateTime": "String (timestamp)"
}