todoTask リソースの種類
名前空間: microsoft.graph
重要
Microsoft Graph のバージョンの /beta API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。
todoTask は、追跡および完了できる作業や個人アイテムなどのタスクを表します。
todoTask は常に todoTaskList に含まれています。 これには、タスクの 1 つ以上のソースを追跡 する linkedResource オブジェクトのコレクションとのリレーションシップが含まれます。
このリソースは、次をサポートしています。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| タスクを一覧表示する | todoTask コレクション | 指定されたリスト内のすべての todoTask リソースを取得します。 |
| タスクを作成する | todoTask | 指定した タスク リストに todoTask を作成する |
| タスクを取得する | todoTask | todoTask オブジェクトのプロパティとリレーションシップを読み取ります。 |
| タスクを更新する | todoTask | todoTask オブジェクトのプロパティを更新します。 |
| タスクを削除する | なし | todoTask オブジェクトを削除します。 |
| チェックリスト項目を一覧表示する | checklistItem コレクション | checklistItems ナビゲーション プロパティから checklistItem リソースを取得します。 |
| checklistItem を作成する | checklistItem | 新しい checklistItem オブジェクトを作成します。 |
| linkedResources を一覧表示する | linkedResource コレクション | linkedResources ナビゲーション プロパティから linkedResources を取得します。 |
| linkedResources を作成する | linkedResource | 新しい linkedResources オブジェクトを作成します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| 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 | Boolean | タスクに添付ファイルがあるかどうかを示します。 |
| 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 | タスクの簡単な説明。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| attachments | taskFileAttachment コレクション | タスクの添付ファイルのコレクション。 |
| checklistItems | checklistItem コレクション | より複雑な親タスクにリンクされた小さいサブタスクのコレクション。 |
| extensions | extension コレクション | タスクに対して定義されている開いている拡張機能のコレクション。 Null 許容型。 |
| linkedResources | linkedResource コレクション | タスクにリンクされたリソースのコレクション。 |
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"
},
"startDateTime": {
"@odata.type": "microsoft.graph.dateTimeTimeZone"
},
"status": "String",
"title": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"bodyLastModifiedDateTime": "String (timestamp)"
}
フィードバック
フィードバックの送信と表示