todoTask リソースの種類

名前空間: microsoft.graph

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	タスクが終了する予定の日時 (指定のタイム ゾーン)。
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	タスクのアラーム通知を行う日時。
status	taskStatus	タスクの状態または進行状況を示します。 可能な値は、notStarted、inProgress、completed、waitingOnOthers、deferred です。
title	String	タスクの簡単な説明。

リレーションシップ

リレーションシップ	型	説明
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"
  },
  "status": "String",
  "title": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "bodyLastModifiedDateTime": "String (timestamp)"
}