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

[アーティクル]
04/04/2024

名前空間: microsoft.graph

重要

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

注意

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

作業項目や個人アイテムなど、追跡および完了できるタスクを表す抽象型。

これは、タスクリソースによって継承される基本型です。

メソッド

メソッド	戻り値の種類	説明
baseTasks を一覧表示する	baseTask コレクション	baseTask オブジェクトとそのプロパティの一覧を取得します。
baseTask の作成	baseTask	新しい baseTask オブジェクトを作成します。
baseTask を取得する	baseTask	baseTask オブジェクトのプロパティとリレーションシップを読み取ります。
baseTask の更新	baseTask	baseTask オブジェクトのプロパティを更新します。
baseTask を削除する	なし	baseTask オブジェクトを削除します。
move	baseTask	メッセージを別のリストに移動します。
差分	baseTask コレクション	指定したリストで追加、削除、または更新された baseTask オブジェクトのセットを取得します。
list checklistItems	checklistItem コレクション	checklistItems ナビゲーションプロパティから checklistItem リソースを取得します。
checklistItem を作成する	checklistItem	新しい checklistItem オブジェクトを作成します。
linkedResources を一覧表示する	コレクションlinkedResource_v2	linkedResources ナビゲーションプロパティから linkedResource_v2 リソースを取得します。
linkedResource_v2の作成	linkedResource_v2	新しい linkedResource_v2 オブジェクトを作成します。

プロパティ

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

リレーションシップ

リレーションシップ	型	説明
checklistItems	checklistItem コレクション	より複雑な親タスクにリンクされた小さいサブタスクのコレクション。
extensions	extension コレクション	タスクに対して定義されている開いている拡張機能のコレクション。
linkedResources	コレクションlinkedResource_v2	タスクにリンクされているリソースのコレクション。
parentList	baseTaskList	タスクを含むリスト。

JSON 表記

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

{
  "@odata.type": "#microsoft.graph.baseTask",
  "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)"
}