タスクリソースの種類 (非推奨)

[アーティクル]
06/01/2022

名前空間: microsoft.graph

重要

Microsoft Graph のバージョンの /beta API は変更される可能性があります。実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。

注意事項

baseTask に基づいて構築された To Do API セットは、2022 年 5 月 31 日より非推奨となり、2022 年 8 月 31 日にデータの返しを停止します。 todoTask に基づいて構築された API セットを使用してください。

追跡および完了できるタスク (一部の作業や個人アイテムなど) を表します。 タスク は常に基本タスクリストに含まれます。

このリソースは、次をサポートしています。

開いている拡張機能でカスタムプロパティとしてデータを追加します。
変更通知を受信します。
差分クエリを使用して、増分追加、削除、更新を追跡します。

baseTask から継承します。

メソッド

メソッド	戻り値の種類	説明
タスクを一覧表示する	task コレクション	タスクオブジェクトとそのプロパティの一覧を取得します。
タスクを取得する	タスク	タスクオブジェクトのプロパティとリレーションシップを読み取ります。
タスクを更新する	タスク	タスクオブジェクトのプロパティを更新します。
タスクを削除する	なし	タスクオブジェクトを削除します。
move	baseTask	メッセージを別のリストに移動します。
チェックリスト項目を一覧表示する	checklistItem コレクション	checklistItems ナビゲーションプロパティから checklistItem リソースを取得します。
checklistItem を作成する	checklistItem	新しい checklistItem オブジェクトを作成します。
linkedResources を一覧表示する	linkedResource_v2 コレクション	linkedResources ナビゲーションプロパティからlinkedResource_v2リソースを取得します。
linkedResource を作成する	linkedResource_v2	新しいlinkedResource_v2 オブジェクトを作成します。

プロパティ

プロパティ	型	説明
textbody	itemBody	通常、タスクに関する情報を含むテキスト形式のタスク本文。 baseTask から継承されます。
bodyLastModifiedDateTime	DateTimeOffset	タスクが最後に変更された日時。既定では、UTC 時間です。要求ヘッダーでカスタムタイムゾーンを使用できます。プロパティの値は、ISO 8601 形式を使って表され、常に UTC 時間です。たとえば、2020 年 1 月 1 日の午前 0 時の UTC は、"2020-01-01T00:00:00Z" のようになります。 baseTask から継承されます。
CompletedDateTime	DateTimeOffset	タスクが完了した日付。 baseTask から継承されます。
createdDateTime	DateTimeOffset	タスクが作成された日時。既定では、UTC 時間です。要求ヘッダーでカスタムタイムゾーンを使用できます。プロパティの値は、ISO 8601 形式を使用します。たとえば、2020 年 1 月 1 日の午前 0 時の UTC は、"2020-01-01T00:00:00Z" のようになります。 baseTask から継承されます。
displayName	String	タスクの名前を指定します。 baseTask から継承されます。
dueDateTime	dateTimeTimeZone	タスクが終了する予定の日時 (指定のタイムゾーン)。 baseTask から継承されます。
id	String	タスクの一意識別子。既定では、タスクをリストから別のリストに移動しても、この値は変更されません。 baseTask から継承されます。
importance	importance	タスクの重要性。可能な値は `low`、`normal`、`high` です。 baseTask から継承されます。使用可能な値: `low`、`normal`、`high`。
lastModifiedDateTime	DateTimeOffset	タスクが最後に変更された日時。既定では、UTC 時間です。要求ヘッダーでカスタムタイムゾーンを使用できます。プロパティの値は、ISO 8601 形式を使って表され、常に UTC 時間です。たとえば、2020 年 1 月 1 日の午前 0 時の UTC は、"2020-01-01T00:00:00Z" のようになります。 baseTask から継承されます。
視点	taskViewpoint	reminderDateTime やカテゴリなどのユーザーに対して個人用のプロパティ。 baseTask から継承されます。
recurrence	patternedRecurrence	タスクの繰り返しパターン。 baseTask から継承されます。
startDateTime	dateTimeTimeZone	タスクを開始する日付 (指定のタイムゾーン)。 baseTask から継承されます。
status	taskStatus_v2	タスクの状態または進行状況を示します。指定できる値は次のとおりです。 notStarted``inProgress``completed``unknownFutureValue baseTask から継承されます。

リレーションシップ

リレーションシップ	型	説明
checklistItems	checklistItem コレクション	タスクにリンクされたチェックリストアイテムのコレクション。 baseTask から継承
extensions	extension コレクション	タスクに対して定義されている開いている拡張機能のコレクション。 baseTask から継承
linkedResources	linkedResource_v2 コレクション	タスクにリンクされたリソースのコレクション。 baseTask から継承
parentList	baseTaskList	タスクを含むリスト。 baseTask から継承

JSON 表記

リソースの JSON 表記を次に示します。

{
  "@odata.type": "#microsoft.graph.task",
  "textBody": "String",
  "createdDateTime": "String (timestamp)",
  "lastModifiedDateTime": "String (timestamp)",
  "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"
  },
  "id": "String (identifier)"
}

タスク リソースの種類 (非推奨)

メソッド

プロパティ

リレーションシップ

JSON 表記

フィードバック

タスクリソースの種類 (非推奨)